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Kotlin 是 一 种 新 型 语言 且 具 有 较 好 的 稳定 性 ， 并 可 在 所 有 Android 设备 上 运行 ， 同 时 
还 解决 了 Java 无 法 处 理 的 许多 问题 。Kotlin 为 Android 开发 平台 引入 了 许多 已 被 证 实 的 编 
程 概念 ， 使 得 开发 过 程 变 得 更 加 轻松 ， 并 可 生成 更 具 安全 性 、 表 现 力 和 简洁 的 代码 。 

本 书 详细 阐述 了 与 Kotlin 程序 设计 相关 的 基本 解决 方案 , 主要 包括 Kotlin 语言 基础 知 
识 、 函 数 、 类 和 对 象 、 泛 型 、 扩 展 函数 和 属性 、 委 托 机 制 ， 以 及 Marvel Gallery 项 目 实战 
等 内 容 。 此 外 ， 本 书 还 提供 了 相应 的 示例 、 代 码 ， 以 帮助 读者 进一步 理解 相关 方案 的 实现 
过 程 。 

在 本 书 的 翻译 过 程 中 ， 除 张 博之 外 ， 周 建 娟 、 李 秋 霞 、 程 晓 舌 、 黄 丽 臣 、 于 讲 寄 、 刘 
Fh. RAR. ERE. GRA. TRG. KU. PGR. EA. Td. TR. TERRE. E EORR. 
ER. PRR, KUT, RE, IKER KUM. TKS A WES PAE IE, 
在 此 一 并 表示 感谢 。 
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当前 ，Android 应 用 程序 开发 已 成 普遍 之 势 。 在 过 去 的 几 年 中 ， 人 们 见证 了 各 种 工具 
的 发 展 历程 ， 同 时 ， 技 术 的 发 展 也 让 我 们 的 生活 变 得 更 为 便捷 。 尽 管 如 此 ，Android 应 用 
程序 开发 的 核心 元 素 却 从 未 发 生 改变 ， 即 Java。Android 平台 可 适应 新 版 本 的 Java， 但 一 
般 需要 等 待 很 长 一 段 时 间 ， 直 到 最 新 的 Android 设备 达到 一 定 的 市 场 规模 。 此 外 ，Java 应 
日 程序 开发 也 面临 着 一 系列 的 挑战 ， 其 原因 在 于 : Java 是 一 种 古老 的 语言 ， 存 在 着 某 些 设 
计 问 题 ， 考虑 到 向 后 兼容 性 的 限制 ， 这 些 问 题 并 不 能 简单 地 予以 解决 。 

另 一 方面 ，Kotlin 是 一 种 新 型 语言 且 具 有 较 好 的 稳定 性 ， 并 可 在 所 有 Android 设备 上 
运行 ， 同 时 还 解决 了 Java 无 法 处 理 的 许多 问题 。Kotlin 为 Android 开发 平台 引入 了 许多 已 
被 证 实 的 编程 概念 ， 使 得 开发 过 程 变 得 更 加 轻松 ， 并 可 生成 更 具 安 全 性 、 表 现 力 和 简洁 的 
代码 。 

本 书 内 容 具 有 易于 阅读 、 实 用 性 强 等 特征 ， 将 帮助 读者 提升 、 改 进 Android 平台 上 的 
Kotlin 开发 体验 。 另 外 ， 本 书 将 在 Java 和 解决 常见 问题 的 新 方法 上 提供 许多 “快捷 方式 ” 
和 改进 方案 。 在 本 书 的 最 后 ， 读 者 将 熟悉 Kotlin 的 各 项 功能 和 相关 工具 ， 并 具备 在 Kotlin 
中 开发 Android 应 用 程序 的 能 力 。 


本 书 内 容 


第 1 章 讨论 Kotlin 语言 及 其 特性 ， 同 时 闻 述 为 何 要 使 用 这 门 语言 进行 开发 。 随 后 将 引 
X Kotlin 平台 ， 并 展示 Kotlin 与 Android 之 间 的 适 配 方式 。 

第 2 章 主 要 涉及 Kotlin 的 模块 构建 ， 并 展示 该 语言 中 的 各 种 结构 、 数 据 类 型 ， 以 及 诸 
多 简化 特性 。 

第 3 章 介绍 函数 的 定义 和 调用 方式 、 函 数 限定 符 以 及 函数 的 定义 位 置 。 

第 4 章 介绍 Kotlin 语言 中 与 面向 对 象 相关 的 各 种 特性 ， 读 者 将 领略 不 同 的 类 定义 ， 以 
及 与 可 读 性 相关 的 某 些 改进 特性 ， 如 属性 操作 符 重 载 和 中 绥 调 用 。 

第 5 章 讨论 了 Kotlin 所 支持 的 函数 编程 。 

第 6 章 探讨 泛 型 类 、 接 口 以 及 函数 等 内 容 ， 并 深入 考察 Kotlin 中 的 泛 型 机 制 。 

第 7 章 介 绍 如 何 向 现 有 类 中 添加 新 的 操作 行为 ， 且 无 须 使 用 继承 机 制 。 除 此 之 外 ， 还 
将 考察 集合 、 流 处 理 方面 的 简单 操作 方法 。 

第 8 章 将 阐述 Kotlin 中 类 委托 模式 的 简化 方式 ， 这 也 是 该 语言 内 建 特性 之 一 。 同 时 还 
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将 展示 内 建 属性 委托 和 自 定义 委托 的 应 用 方式 。 
第 9 章 将 通过 本 书 所 讨论 的 诸多 特性 编写 一 个 功能 丰富 的 Android 应 用 程序 。 


准备 工作 


当 测试 并 使 用 本 书 中 的 代码 时 ， 读 者 只 需 安装 Android Studio 即 可 。 第 1 章 解 释 了 如 
何 启动 新 项 目 、 对 应 代码 示例 的 检查 方式 ， 以 及 大 部 分 代码 在 未 安装 任何 程序 的 情况 下 如 
何 进行 测试 。 

适用 读者 


当 阅 读本 书 时 ， 读 者 应 熟悉 以 下 两 方面 内 容 : 

o 了 解 Java 和 面向 对 象 的 编程 概念 ， 包 括 对 象 、 类 、 构 造 方法 、 接 口 、 方 法 、getter 
Hik, setter 方法 和 泛 型 类 型 。 和 否则 ， 读 者 将 很 难 理解 本 书 中 的 相关 内 容 。 对 此 ， 读 
者 可 阅读 任何 一 本 Java 语言 的 入 门 书籍 。 

e 读 者 应 尽量 了 解 Android 平台 , 从 而 可 深入 理解 书 中 所 展示 的 各 项 示例 , 以 及 Kotlin 
所 处 理 的 各 种 问题 。 当 然 ， 本 书 对 此 并 不 做 强制 性 要 求 。 如 果 读 者 是 一 名 拥有 6 一 
12 个 月 编程 经 验 的 Android 开发 者 ， 抑 或 曾 编写 了 少量 的 Android 应 用 程序 ， 那 么 
本 书 将 十 分 适合 你 。 另 一 方面 ， 如 果 读 者 了 解 OOP 概念 ,但 对 Android 平台 了 解 有 
限 ， 那 么 仍 可 阅读 本 书 的 大 部 分 内 容 。 

同时 ， 也 希望 读者 具备 开阔 的 头脑 ， 以 及 对 新 技术 的 渴望 之 心 ， 这 对 于 程序 设计 学 习 

来 说 十 分 有 益 。 如 果 本 书 内 容 在 某 些 方面 引起 了 读者 的 好 奇 之 心 ， 那 么 尽 可 大 胆 尝试 。 


本 书 约定 
代码 块 通过 下 列 方式 设置 : 


val capitol = "England" to "London" 
println(capitol.first) // Prints: England 
println(capitol.second) // Prints: London 


代码 中 的 重点 内 容 则 采用 黑体 表示 : 


ext.kotlin version = '1.1.3' 

repositories ( 
maven ( url 'https://maven.google.com' } 
jcenter() 




































































) 
命令 行 输入 或 输出 如 下 所 示 : 


Sdk install kotlin 


Til 
< 


前 


@ 图 标 表示 较为 重要 的 说 明 事 项 。 





&D 图 标 则 表示 提示 信息 和 操作 技巧 。 


读者 反馈 和 客户 支持 


欢迎 读者 对 本 书 的 建议 或 意见 予以 反馈 ， 以 进一步 了 解读 者 的 阅读 喜好 。 反 馈 意见 对 
于 我 们 来 说 十 分 重要 , 以便 改进 我 们 日 后 的 工作 。 对 此 , 读者 可 向 feedback@ packtpub.com 
发 送 邮件 ， 并 以 书 名 作为 邮件 标题 。 若 读者 针对 某 项 技术 具有 专家 级 的 见解 ， 抑 或 计划 撰 
写 书籍 或 完善 某 部 著作 的 出 版 工作 ， 则 可 访问 www.packtpub.com/ authors。 

对 于 本 书 的 读者 ， 我 们 将 对 每 一 名 用 户 提供 竭诚 的 服务 。 


资源 下 载 


读者 可 访问 http//www.packtpub.com 并 通过 个 人 账户 下 载 示 例 代 码 文件 。 另 外 ， 在 
http://www.packtpub.com/support 中 注册 成 功 后 ， 我 们 将 以 电子 邮件 的 方式 将 相关 文件 发 与 
读者 。 

读者 可 根据 下 列 步 骤 下 载 代码 文件 : 

e 通过 个 人 电子 邮件 地 址 和 密码 登录 并 注册 我 们 的 网 站 。 

e 选择 SUPPORT 选项 卡 。 

e 单 击 Code Downloads & Errata. 

e TE Search 文本 框 中 输入 书 名 。 

e 选 择 本 书 对 应 的 代码 文件 。 

e 从 下 拉 菜 单 中 选择 本 书 的 购买 方式 。 

e 单 击 Code Download. 

o 当 文件 下 载 完 毕 后 ， 确 保 使 用 下 列 最 新 版 本 软件 解压 文件 夹 : 

e Windows 系统 下 的 WinRAR/7-Zip。 

e Mac 系统 下 的 Zipeg/iZip/UnRarX。 

e Linux 系统 下 的 7-Zip/PeaZip。 

另外 ， 读 者 还 可 访问 GitHub 获取 本 书 的 代码 包 ， 对 应 网 址 为 https://github.com/Packt 
Publishing/Android-Development-with-Kotlin。 此 外 ， 读 者 还 可 访问 https://github.com/Packt 
Publishing/ 以 了 解 丰富 的 代码 和 视频 资源 。 
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勘误 表 


尽管 我 们 在 最 大 程度 上 做 到 尽善尽美 , 但 错误 依然 在 所 难免 。 如 果 读者 发 现 廖 误 之 处 ， 
无 论 是 文字 错误 抑或 是 代码 错误 ， 还 望 不 音 赐教 。 对 于 其 他 读者 以 及 本 书 的 再 版 工作 ， 这 
将 具有 十 分 重要 的 意义 。 对 此 ， 读 者 可 访问 http://www.packtpub.com/submit-errata， 选 取 对 
应 书籍 ， 单 击 ErrataSubmissionForm 超 链 接 ， 并 输入 相关 问题 的 详细 内 容 。 经 确认 后 ， 填 








写 内 容 将 被 提交 至 网 站 ， 或 添加 至 现 有 勘误 表 中 (位 于 该 书籍 的 Errata ii 











PM 


另外 ,读者 还 可 访问 http://www.packtpub.com/books/content/support 查看 之 前 的 勘误 表 。 


在 搜索 框 中 输入 书 名 后 ， 所 需 信息 将 显示 于 Errata 项 中 。 


H 





版 权 须 知 


一 直 以 来 ， 互 联网 上 的 版 权 问题 从 未 间断 ，Packt 出 版 社 对 此 类 问题 异常 重视 。 若 读 
者 在 互联 网 上 发 现 本 书 任意 形式 的 副本 ， 请 告知 网 络 地 址 或 网 站 名 称 ， 我 们 将 对 此 予以 


处 理 。 


关于 盗版 问题 ， 读 者 可 发 送 邮件 至 copyright@packtpub.com。 
对 于 作者 的 爱护 ， 我 们 表示 衷心 的 感谢 ， 并 于 日 后 向 读者 呈现 更 为 精彩 的 作品 。 


问题 解答 


若 读者 对 本 书 有 任何 疑问 ， 均 可 发 送 邮件 至 questions@packtpub.com， 我 们 将 竭诚 为 


您 服务 。 
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第 1 章 开启 Kotlin 编程 之 旅 


Kotlin 是 一 门 伟大 的 语言 ， 可 简化 Android 的 开发 流程 。 本 章 将 讨论 Kotlin 语言 中 的 
具体 内 容 ， 并 考察 大 量 的 Kotlin 示例 ， 以 编写 更 好 的 Android 应 用 程序 。 欢 迎 来 到 Kotlin 
的 奇妙 旅程 ， 这 将 改变 读者 编写 代码 的 思考 方式 ， 以 及 常见 编程 问题 的 处 理 方 式 。 

本 章 主要 涉及 以 下 内 容 : 

e Kotlin 语言 中 的 第 一 步 。 

o Kotlin 语言 中 的 操作 示例 。 

e 在 Android Studio 中 创建 Kotlin 项 目 。 

o HIH Java 项 目 迁移 至 Kotlin 中 。 

e Kotlin 标准 库 Cstdlib). 

e 为 何 选择 Kotlin 语言 。 

















1.1 Kotlin 语言 简介 


Kotlin 是 一 种 静态 类 型 的 、 兼 容 Android 的 现代 程序 设计 语言 ， 并 修复 了 许多 Java 中 
的 问题 ， 如 空 指针 异常 或 代码 元 余 。Kotlin 是 受 Swift、Scala、Groovy、C# 等 启发 而 形成 
的 一 种 语言 。Kotlin 由 JetBrains 公司 推出 ,集合 了 两 种 语言 中 的 编程 经 验 、 应 用 准则 〈 简 
洁 性 和 高 效 性 ) 以 及 数据 类 型 。 经 过 对 其 他 语言 进行 分 析 ，Kotlin 尽量 避免 重复 其 他 语言 
中 的 错误 ， 并 集中 了 各 种 语言 中 最 有 效 的 特性 。 在 采用 Kotlin 编写 程序 时 ， 明 显 可 感觉 到 
这 是 一 种 成 熟 而 优秀 的 编程 语言 。 

Kotlin 通过 提高 代码 质量 、 安 全 性 以 及 开发 效率 ， 将 应 用 程序 设计 提升 到 一 个 全 新 的 
水 平 。Google 在 2017 年 发 布 了 支持 Android 平台 的 官方 Kotlin 语言 ， 但 Kotlin 的 出 现 已 
经 有 一 段 时 间 。Kotlin 社区 一 直 处 于 非常 活跃 的 状态 ， 而 Kotlin 在 Android 平台 上 的 应 
日 也 处 于 持续 增长 中 。 可 以 将 Kotlin 描述 为 一 个 安全 的 、 有 表现 力 的 、 简 洁 的 、 通 用 的 、 
工具 友好 的 语言 ， 且 与 Java 和 JavaScript 具有 很 强 的 互 操作 性 。 相 关 特 性 如 下 所 示 : 

e 安全 性 。Kotlin 的 安全 特性 体现 在 可 空 性 Cnullability) 和 不 变性 方面 。Kotlin 是 静 

态 类 型 的 语言 ， 所 以 每 个 表达 式 的 类 型 在 编译 时 均 为 已 知 。 编 译 器 可 以 验证 试图 访 
问 的 任何 属性 或 方法 ， 或 者 某 个 真实 存在 的 特定 类 实例 。 作 为 一 种 静态 类 型 语言 ， 
Java 也 具有 该 特征 ; 但 与 Java 不 同 ，Kotlin 类 型 系统 更 加 严格 〈 安 全 )。 对 此 ， 须 
明确 告知 编译 器 : 给 定 的 变量 是 否 可 以 存储 空 值 。 这 使 得 程序 在 编译 时 即 失 效 ， 而 















































6.088 零 基础 学 Kotlin 编程 


不 是 在 运行 期 内 抛 出 NullPointerException， 如 图 1.1 所 示 。 


MyApplication has stopped 


Œ Openappagain 





图 1.1 


e 更 加 简单 的 调试 机 制 。 在 开发 阶段 即 可 快速 检测 到 bug， 而 不 是 在 发 布 后 导致 应 上 

星 序 崩溃 ， 从 而 破坏 用 户 体验 。Kotlin 提供 了 一 种 使 用 不 可 变数 据 的 便捷 方法 。 例 

如 ， 可 以 通过 提供 方便 的 接口 来 区 分 可 变 〈 读 - 写 ) 和 不 可 变 (只 读 ) 集合 (集合 中 
仍然 是 可 变 的 )。 

o 简洁 性 。Kotlin 消除 了 Java 中 大 多 数 的 宛 余 内 容 ， 仅 需 更 少 的 代码 即 可 实现 常见 的 
任务 ， 因 此 ， 即 使 将 Kotlin 与 Java 8 相 比 ， 样 板 文件 代码 的 数量 也 大 大 减少 。 因 此 ， 
代码 也 更 容易 阅读 和 理解 (表达 )。 

e 互 操作 性 。Kotlin 被 设计 成 可 与 Java 跨 语言 项 目 ) 无 颖 工作 。 也 就 是 说 ， 现 有 的 
Java 库 和 框架 可 与 Kotlin 协同 工作 ， 且 不 存在 任何 性 能 上 的 损失 。 许多 Java 库 甚至 
包含 特定 的 Kotlin 版 本 ， 人 允许 在 Kotlin 中 实现 某 些 习 惯用 法 。 另 外 。Kotlin 类 也 可 
以 直接 由 Java 代码 予以 实例 化 和 透明 引用 , 且 无 须 添加 任何 特殊 的 语义 , 反之 亦 然 。 
因此 ， 可 将 Kotlin 合并 到 现 有 的 Android 项 目 中 ， 并 实现 Kotlin 和 Java 的 混用 ( 若 
必要 的 话 )。 

e 通用 性 。 对 此 可 定位 多 个 平台 ， 包 括 移动 应 用 〈Android)、 服 务 器 端 应 用 程序 〈 后 
端 )、 桌 面 应 用 程序 、 在 浏览 器 中 运行 的 前 端 代码 ， 甚 至 构建 系统 〈Gradle)。 

任何 编程 语言 只 有 在 相关 工具 的 辅助 下 方 可 表现 得 更 为 优异 。 为 此 ， 多 种 IDE 均 可 完 

美 支持 Kotlin， 例 如 Android Studio. IntelliJ Idea 和 Eclipse， 一 些 常见 任务 〈 如 代码 辅助 
REK) 同样 得 到 了 较 好 的 处 理 。 在 发 布 的 每 个 版 本 中 ，Kotlin 团队 均 致力 于 提供 优秀 的 
Kotlin 插件 。 另 外 ， 大 多 数 bug 均 可 实现 快速 修复 ， 同 时 ， 社 区 中 提出 的 诸多 特性 都 得 以 
最 终 实现 。 
读者 可 访问 https://youtrack.jetbrains.com/issues/KT 下 载 Kotlin 错误 跟踪 器 。 
qp 读者 可 访问 http:// slack. kotlinlang. org/ 以 了 解 Kotlin Slack Channel. 














































































































当 采 用 Kotlin 语言 时 , Android 应 用 程序 开发 变 得 更 加 高 效 和 轻松 .Kotlin 兼容 于 IDK 
6， 因 此 在 Kotlin 中 创建 的 应 用 程序 甚至 可 以 安全 地 运行 在 Android 设备 上 (Android 4 
之 前 )。 
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Kotlin 完美 结合 了 过 程式 和 函数 式 编程 中 的 概念 和 元 素 ， 并 遵循 了 Effective Java, 2nd 
Edition 一 书 中 的 设计 理念 。 该 书 由 Joshua Bloch 编写 , 同时 也 是 每 一 位 Java 开发 人 员 的 必 
备 读物 。 
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对 于 Android FRA ARV, Kotlin 易于 学 习 ， 其 语法 与 Java 较为 类 似 ; Kotlin 可 视 
为 Java 的 自然 进化 结果 。 在 开始 阶段 ，Kotlin 代码 往往 无 法 摆脱 Java 风格 ; 但 经 过 一 段 时 
间 后 ， 一 般 会 较为 自然 地 转向 Kotlin 方案 。 下 面 考察 一 些 较为 有 趣 的 Kotlin 示例 。 其 中 ， 
对 于 常见 问题 求解 ，Kotlin 可 提供 更 加 简洁 、 灵 活 的 方法 。 相 关 示 例 尽 量 保持 简单 且 具 有 
自 解释 功能 ， 但 会 涉及 本 书 中 的 后 续 内 容 ， 读 者 如 不 能 理解 其 中 内 容 实 属 正 常 现象 。 本 节 
主要 讨论 Kotlin 语言 可 实现 的 各 种 功能 ， 但 暂时 不 关注 其 中 的 细节 内 容 ， 下 面 首先 从 变量 
的 声明 开始 ， 如 下 所 示 : 

var name = "Igor" // Inferred type is String 

name - "Marcin" 
注意 ，Kotlin 可 以 不 使 用 分 号 。 当 然 ， 作 为 可 选项 ， 读 者 依然 可 继续 使 用 。 另 外 ， 也 不 需 
要 指定 一 个 变量 类 型 ， 因 为 具体 类 型 是 从 上 下 文中 推断 出 来 的 。 每 次 编译 器 都 可 以 从 上 下 
文 找 出 类 型 ， 因 而 不 必 显 式 地 予以 指定 。Kotlin 是 一 种 强 类 型 语言 ， 所 以 每 个 变量 都 应 包 
含 适 当 的 类 型 : 

var name = "Igor" 

name - 2 // Error, because name type is String 


该 变量 定义 了 一 个 推断 String 类 型 ， 因 此 分 配 一 个 不 同 的 值 CEO 将 导致 编译 错误 。 下 
面 是 Kotlin 的 改进 方案 ， 即 如 何 通过 使 用 字符 串 模 板 添加 多 个 字符 串 : 


val name = "Marcin" 
println("My name is $name") // Prints: My name is Marcin 


此 处 并 不 需要 使 用 + 字符 连接 字符 串 。 在 Kotlin 中 ， 可 以 很 方便 地 将 单个 变量 ， 甚 至 整个 
表达 式 合并 到 字符 串 常量 中 ， 如 下 所 示 : 


val name - "Igor" 
println("My name is $(name.toUpperCase()]") 
// Prints: My name is IGOR 
在 Java 中 ， 任 何 变量 都 可 以 存储 null (A. TE Kotlin 严格 的 空 保护 机 制 中 ， 则 强制 要 求 我 
们 明确 标记 每 个 可 以 存储 可 空 值 的 变量 ， 如 下 所 示 : 
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var a: String = "abc" 
a = null // compilation error 


var b: String? - "abc" 

b = null // It is correct 
此 处 将 一 个 问号 添加 到 数据 类 型 中 (String 和 String?)， 即 表明 变量 是 可 空 的 (可 以 存储 空 
引用 ); 和 否则 将 无 法 为 其 分 配 一 个 空 引用 。Kotlin 还 允许 以 适当 的 方式 处 理 可 空 变量 , 例如 
可 使 用 安全 调用 操作 符 调用 基于 空 变量 的 方法 ， 如 下 所 示 : 

savedInstanceState?.doSomething 
仅 当 savedInstanceState 包含 非 空 值 的 情况 下 才 会 调用 doSomething 方法 ; 否则 该 方法 调用 
将 被 忽略 。 这 是 Kotlin 避免 Java 中 常见 的 空 指针 异常 的 一 种 安全 方法 。 

Kotlin 还 涵盖 了 一 些 新 的 数据 类 型 ， 例 如 Range 数据 类 型 ， 可 定义 相应 的 终止 范 目 
如 下 所 示 : 

foe ti in 1- rop 1 

print (i) 

} // 12345678910 

AS, Kotlin 还 引入 了 Pair SHER, SS Perici EA, PRR IL A Be 
值 对 ， 如 下 所 示 : 

val capitol = "England" to "London" 


println(capitol.first) // Prints: England 
println(capitol.second) // Prints: London 


对 此 ， 可 采用 解构 声明 将 其 分 解 为 独立 变量 ， 如 下 所 示 : 


val (country, city) = capitol 
println(country) // Prints: England 
println(city) // Prints: London 


甚至 还 可 遍历 数值 对 列表 ， 如 下 所 示 : 


val capitols = listOf("England" to "London", "Poland" to "Warsaw") 
for ((country, city) in capitols) ( 
println("Capitol of $country is $city") 



















































































Eu 








) 


W: Prints: 
// Capitol of England is London 
// Capitol of Poland is Warsaw 


除 此 之 外 ， 还 可 使 用 forEach 函数 ， 如 下 所 示 : 
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val capitols = listof("England" to "London", "Poland" to "Warsaw") 
capitols.forEach { (country, city) -> 

println("Capitol of $country is $city") 
} 








需要 注意 的 是 ，Kotlin 提供 了 一 组 接口 和 帮助 方法 (List 和 MutableList，Set 和 
MutableSet, Map 和 MutableMap 等 )， 进 而 区 分 可 变 和 只 读 集 合 ， 如 下 所 示 : 
val list = listOf(1, 2, 3, 4, 5, 6) // Inferred type is List 


val mutableList = mutableListOf(1, 2, 3, 4, 5, 6) 
// Inferred type is MutableList 


里 ， 只 读 集合 表示 ， 初 始 化 之 后 集合 状态 将 无 法 变更 (无 法 添加 、 移 除数 据 项 )， 相 比 
下 ， 可 变 集合 则 可 对 状态 进行 调整 。 
当 采 用 Lambda 表达 式 时 ， 还 可 通过 非常 简洁 的 方式 使 用 Android 框架 ， 如 下 所 示 : 


view.setOnClickListener { 
println ("Click") 











这 
> 














} 


Kotlin 标准 库 中 定义 了 多 种 函数 ， 并 以 简洁 的 方式 执行 各 项 集合 操作 。 例 如 ， 可 在 列 
表 上 进行 流 处 理 ， 如 下 所 示 : 


val text = capitols.map ( (country, ) -> country.toUpperCase() ) 
-onEach ( println(it) } 
.filter ( it.startsWith("P") } 


-joinToString (prefix = "Countries prefix P:") 
// Prints: ENGLAND POLAND 


println(text) // Prints: Countries prefix P: POLAND 
-joinToString (prefix = "Countries prefix P:") 


注意 ， 无 须 向 某 个 Lambda 传递 参数 ， 可 自 定 义 Lambda， 并 以 一 种 全 新 的 方式 编写 代码 。 
Lambda {XE Android Marshmallow (或 更 新 的 版 本 ) 中 运行 特定 的 代码 片段 ， 如 下 所 示 : 


inline fun supportsMarshmallow(code: () -> Unit) { 


if(Build.VERSION.SDK INT »- Build.VERSION CODES.M) 
code () 
t 


//usage 
supportsMarshmallow { 


printin("This code will only run on Android Nougat and newer") 
l 
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可 以 使 用 doAsync 函数 轻松 地 在 主线 程 上 进行 异步 请 求 并 显示 响应 结果 ， 如 下 所 示 : 


doAsync ( 
var result = runLongTask() // runs on background thread 


uiThread ( 
toast (result) // run on main thread 


) 
) 


另外 ， 智 能 转换 (Smart Cast) 可 采用 更 加 简洁 的 方式 编写 代码 ， 如 下 所 示 : 


mf (x ds String) T 
print (x.length) // x is automatically casted to String 
I 


x.length //error, x is not casted to a String outside if block 


if (x !is String) 
return 


x.length // x is automatically casted to String 


在 检测 完毕 后 ，Kotlin 编译 器 知晓 变量 x 表示 为 String 类 型 ， 因 而 自动 将 其 转换 为 String 
类 型 ， 进 而 调用 全 部 方法 并 访问 String 类 中 的 全 部 属性 ， 且 无 须 显 式 地 进行 转换 。 

某 些 时 候 ， 一 些 简 单 的 函数 返回 单个 表达 式 的 值 。 在 这 种 情况 下 ， 可 以 使 用 基于 表达 
式 体 Cexpression body) 的 函数 来 简化 语法 ， 如 下 所 示 : 

fun sum(a: Int, b: Int) = a + b 

println (sum(2 + 4)) // Prints: 6 

当 采 用 默认 参数 语法 时 , 可 针对 各 个 函数 参数 定义 默认 值 , 并 通过 多 种 方式 进行 调用 ， 
如 下 所 示 : 

fun printMessage (product: String, amount: Int = 0, 


name: String = "Anonymous") { 
printin("$name has $amount $product") 




















} 

printMessage ("oranges") // Prints: Anonymous has 0 oranges 
printMessage ("oranges", 10) // Prints: Anonymous has 10 oranges 
printMessage ("oranges", 10, "Johny") 

// Prints: Johny has 10 oranges 


唯一 的 限制 条 件 是 ， 若 未 设置 默认 值 ， 需 要 提供 全 部 参数 。 除 此 之 外 ， 还 可 使 用 命名 
参数 语法 确定 函数 参数 ， 如 下 所 示 : 
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printMessage("oranges", name = "Bill") 
当 在 函数 调用 过 程 中 调用 包含 多 个 参数 的 函数 时 ， 这 也 提升 了 代码 的 可 读 性 。 

数据 类 提供 了 一 种 非常 简单 的 方法 来 定义 和 操作 来 自 数据 模型 的 类 。 当 定义 一 个 数据 
类 时 ， 可 在 类 名 之 前 使 用 data 限定 符 ， 如 下 所 示 : 


data class Ball(var size:Int, val color:String) 














val ball = Ball(12, "Red") 
println (ball) // Prints: Ball(size-12, color-Red) 


注意 , 此 处 生成 一 个 类 实例 , 且 包 含 了 具有 可 读 性 的 字符 串 表达 形式 ; 同时 , 无 须 使 用 new 
关键 字 初 始 化 当前 类 。 除 此 之 外 ， 还 可 方便 地 创建 该 类 的 副本 ， 如 下 所 示 : 

val ball = Ball(12, "Red") 

println(ball) // prints: Ball(size-12, color-Red) 

val smallBall - ball.copy(size - 3) 

println(smallBall) // prints: Ball(size-3, color-Red) 

smallBall .size++ 

println(smallBall) // prints: Ball(size-4, color-Red) 

println(ball) // prints: Ball(size-12, color-Red) 


上 述 构造 过 程 可 简单 、 方 便 地 与 不 可 变 对 象 协同 工作 。 

PJE (Extension) Æ Kotlin 语言 中 的 一 个 优异 特性 ， 并 以 此 向 现 有 类 中 添加 新 的 行为 
(方法 或 属性 )， 且 无 须 改变 其 实现 。 某 些 时 候 ， 当 与 某 个 库 或 框架 协同 工作 时 ， 须 针对 特 
定 类 定义 附加 方法 或 属性 ， 则 可 通过 扩展 添加 所 缺失 的 成 员 。 扩 展 降低 了 代码 的 元 余 性 ， 
并 移 除了 Java 中 的 各 种 工具 函数 (例如 StringUtils 类 )。 针 对 自 定 义 类 、 第 三 方 库 ， 甚 至 
是 Android 框架 类 ， 均 可 方便 地 定义 扩展 。 首 先 ，ImageView 并 不 具备 从 网 络 中 加 载 图 像 
的 能 力 , 因而 可 添加 loadImage 扩展 , 并 通过 Picasso 库 加 载 图 像 (Android 的 图 像 加 载 库 )， 
如 下 所 示 : 


fun ImageView.loadUrl(url: String) ( 
Picasso.with (context) .load(url) .into (this) 












































2 


// usage 
imageView.loadUrl ("www.test.com\\imagel.png") 


除 此 之 外 ， 还 可 向 Activity 类 添加 toast 方法 ， 如 下 所 示 : 


fun Context.toast(text:String) ( 
Toast.makeText(this, text, Toast.LENGTH SHORT).show() 
H 
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// usage (inside Activity class) 
toast ("Hello") 


扩展 的 应 用 远 不 止 这 些 ,从 而 可 极 大 地 减少 代码 量 。 当 使 用 Kotlin 时 ,还 可 使 用 Lambda 
进一步 简化 Kotlin 代码 。 
Kotlin 的 接口 可 以 包含 默认 实现 ， 只 要 它们 不 保留 任何 状态 ， 如 下 所 示 : 


interface BasicData { 

val email:String 

val name:String 

get() = email.substringBefore ("Q") 
) 


在 Android 中 ,存在 多 种 应 用 场合 须 延 迟 对 象 的 初始 化 操作 。 对 此 ， 可 使 用 委托 机 制 ， 
如 下 所 示 : 
val retrofit by lazy ( 
Retrofit.Builder() 
-baseUrl ("https://www.github.com") 


.addConverterFactory (MoshiConverterFactory.create()) 
.build() 
































) 


其 中 ，Retrofit (较为 流行 的 Android 网 络 框架 ) 属性 初始 化 操作 将 被 延迟 ， 直 至 首次 
访问 该 值 。 延 迟 初始 化 行为 可 导致 更 快 的 Android 应 用 程序 启动 时 间 一 一 加 载 过 程 将 延迟 
至 变量 首次 访问 时 。 当 在 某 个 类 中 初始 化 多 个 对 象 时 ， 这 可 视 作 一 种 较 好 的 方法 ， 尤 其 是 
仅 使 用 部 分 对 象 四 (针对 某 些 特殊 的 类 应 用 方案 ， 仅 须 使 用 一 些 特定 类 ); 或 者 是 类 创建 
完毕 后 ， 仅 须 使 用 部 分 对 象 时 。 

上 述 内 容 简单 扼要 地 描述 了 Kotlin 可 实现 的 某 些 任务 ,下面 将 讨论 Kotlin 的 应 用 方式 。 
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Kotlin 代码 的 管理 和 运行 机 制 存 在 多 种 方式 ， 本 节 主要 考察 Android Studio 和 Kotlin 
Playground. 


1.8.1 Kotlin Playground 


读者 可 通过 Kotlin Playground 感受 Kotlin 代码 ， 且 无 须 安 装 其 他 软件 ,如 图 1.2 所 示 。 
Kotlin Playground 的 对 应 网 址 为 https://try. kotlinlang. org- 读者 可 采用 JavaScript 或 JVM 的 
Kotlin 实现 运行 代码 ， 并 方便 地 在 Kotlin 的 不 同 版 本 之 间 进 行 切换 。 本 书 的 全 部 代码 示例 





让 
E 
4 
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不 存在 Android 框架 依赖 性 ， 并 可 通过 Kotlin Playground 予以 执行 。 


f 8 Ww 9" E shortcuts || @ Comert trom java 










































( Examples ` Hello, world! ) Simplest version J Simplest version.kt 
4 Examples = i ks | IN ] 
| M sae Saas — —— fun 
4 Hello, worid! : 
1 simplest version | 
ER 
D Reading a name from t.. | ^ 
D Reading many names t.. |) © fun main(args: Arrayestring>) { 
println(*Helle, vorldl*) 
D A multi-language Hello 
E An object-oriented Hello I 
» Basic syntax walk-through 
， Destructuring declarations ar 
» Delegated pri | 
» Callable refe: 
Longer examples 
» Problems 
» canvas 
» Kotlin Koans 042 
? Kotlin in Action 
» Advent of Code (login) - 
mn n (log in) = 
E on-the-fly type checking 
Problems view] Console | Generated classfiles | This demo is running on Kotlin | v.1.1.2 7 








图 1.2 
Hp, main 函数 表示 为 Kotlin 应 用 程序 入 口 点 ， 当 应 用 程序 启动 时 即 调用 该 函数 。 因 此 ， 
需要 将 书 中 的 代码 示例 置 于 该 函数 体 中 。 另 外 ， 读 者 可 直接 放置 代码 ， 或 者 放置 涵盖 更 多 
Kotlin 代码 的 函数 调用 ， 如 下 所 示 : 


fun main(args: Array<String>) { 
println("Hello, world!") 
































Android 应 用 程序 包含 多 个 入 口 点 ,main 函数 被 Android 框架 隐 式 调用 ， 
因而 无 法 使 用 该 函数 在 Android 平台 上 运行 Kotlin KS, 
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1.3.2 Android Studio 





Android Studio 中 的 现 有 全 部 工具 均 可 与 Kotlin 代码 协同 工作 。 据 此 ， 用 户 可 使 用 调 























试 工具 、Lint 检查 、 代 码 提示 以 及 代码 重 构 等 内 容 。 大 多 数 内 容 与 Java 的 工作 方式 并 无 太 


多 差异 ， 其 中 较为 显著 的 变化 是 Kotlin 语法 。 全 部 工作 需要 在 当前 项 目 中 配置 Kotlin。 
Android 应 用 程序 包含 多 个 入 口 点 (可 启动 应 用 程序 中 不 同 的 组 件 ), 同时 具有 Android 























框架 依赖 性 。 当 运行 本 书 中 的 示例 代码 时 ， 需 要 扩展 Activity 类 ， 并 将 代码 置 于 其 中 。 








(1) 在 项 目 中 配置 Kotlin 


É Android Studio 3.0 之 后 , 即 加 入 了 对 Kotlin 语言 的 工具 支持 ,此 处 不 需要 安装 Kotlin 
插件 ，Kotlin 已 深度 集成 至 Android 开发 处 理 中 。 





当 在 Android Studio 2.x 环境 下 使 用 Kotlin 时 , 须 手动 安装 Kotlin 插件 。 在 安装 过 程 中 ， 


可 选择 Android Studio | File | Settings | Plugins | Install JetBrains plugin... | Kotlin， 并 单 击 


Install 按钮 ， 如 图 1.3 所 示 。 
® Settings 


(Q ) Plugins 


> Appearance & Behavior 
Keymap 

Editor 
Plugins 
* Version Control 

> Build, Execution, Deployment 
* Languages & Frameworks 

* Tools 

* Other Settings 


| ® Browse JetBrains Plugins 








(Qr kot ©) Ø Repository: All x | Category: All = | 


Sort by: name" | LANGUAGES 
Kotlin 


Kørt 717163 downloads 


Updated 03.052017 v1.1.2-release-S 


Kotlin language support 
Vendor 

JetBrains s.r.o. 
http://www. jetbrains.com 
Plugin homepage 
http://kotlinlang.org 


图 1.3 


为 了 正常 使 用 Kotlin， 须 在 项 目 中 对 Kotlin 进行 配置 。 针 对 现 有 Java 项 目 ， 须 运行 
Configure Kotlin in project (E Windows 环境 下 ， 对 应 快捷 键 为 ShiftrCtrlHA; 在 macos 环 
HET. REBEX command-shift-A); 或 者 使 用 Tools | Kotlin | Configure Kotlin in Project 3 


单项 ， 如 图 1.4 所 示 。 
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VCS Window Help 
Tasks & Contexts > b B a E [1 c Ẹ A 3 
Save File as Template... à = 

Generate JavaDoc... —— uiae 
IDE Scripting Console 











C2 App Links Assistant 
import iffi Android > 






public " T x 
Configure Kotlin (JavaScript) in Project 
Qoverride Configure Kotlin Plugin Updates 
protected void onCreate(B Show Kotlin Bytecode 
super.onCreate (savedT 


a Decompile Kotlin To Java 
setContentView(R. layc 


Kotlin Internal Mode 
) Create backup for debugging Kotlin incremental compilation 
Fi Kotlin REPL 


图 1.4 
随后 可 选择 Android with Gradle， 如 图 1.5 所 示 。 


Choose Configurator 





Gradle 
图 1.5 
最 后 需要 选取 所 需 模块 以 及 相应 的 Kotlin 版 本 ， 如 图 1.6 所 示 。 





® Configure Kotlin in Project x 
Q All modules 


O Single module: app 


Kotlin compiler and runtime version: | 1.1.2-4 M 
EH 
图 1.6 


上 述 配置 方案 也 适用 于 现 有 的 、Java 最 初创 建 的 全 部 Android 项 目 。 自 Android 
Studio 3.0 起 ， 在 生成 新 项 目的 同时 ， 还 可 同时 选中 Include Kotlin support 复 选 框 ， 如 
图 1.7 所 示 。 
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® Create New Project 





Configure your new project 
Application name: | My Application 


Company domain: | testcom 

Package name: ^ com.testmyapplication 
C Include C++ support 
Include Kotlin support 


E17 


在 图 1.7 所 示 的 两 种 方案 中 ， 通 过 添加 Kotlin 依赖 关系 ，Configure Kotlin in project fit 
令 将 更 新 与 当前 模块 对 应 的 build.gradle 根 文 件 和 build.gradle 文件 ， 除 此 之 外 ， 还 将 向 当 
前 Android 模块 添加 Kotlin 插件 。 在 本 书 编写 时 , Android Studio 3 版 本 尚 不 支持 此 类 功能 ， 
但 可 从 预览 版 本 中 查看 构建 脚本 ， 如 下 所 示 : 

// build.gradle file in project root folder 


buildscript ( 
ext.kotlin version = '1.1"' 





repositories ( 
google () 
jcenter () 
} 
dependencies { 
classpath 'com.android.tools.build:gradle:3.0.0-alpha9' 
classpath "org.jetbrains.kotlin:kotlin-gradleplugin:$ 
kotlin version" 


// build.gradle file in the selected modules 
apply plugin: 'com.android.application' 
apply plugin: 'kotlin-android' 

apply plugin: 'kotlin-android-extensions' 


dependencies ( 
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implementation 'com.android.support.constraint:constraintlayout: 
TOZ 


Æ Gradle 3.x Android 插件 之 前 ( Android Studio 3.0 所 提供 )， 一 般 采 用 
编译 ( 而 非 实现 ) 依赖 性 配置 。 
当 更 新 Kotlin 版 本 时 ， 须 修改 文件 build.gradle〈 位 于 项 目 根 目录 ) 中 的 kotlin version 
变量 值 。Gradle 文件 中 的 变化 内 容 意味 着 当前 项 目 须 实 现 同 步 化 。 因 此 ，Gradle 将 更 新 其 
配置 内 容 ， 并 下 载 全 部 所 需 的 依赖 关系 ， 如 图 1.8 所 示 。 


Gradle files have changed since last project sync. A project sync may be necessary for the IDE to work properly. Sync Now 


FA 1.8 




















(2) 在 Android 新 项 目 中 使 用 Kotlin 
对 于 Android Studio 3.x 中 创建 的 最 新 Kotlin 项 目 , 主要 操作 均 已 在 Kotlin 中 加 以 定义 ， 
随后 即 可 开始 编写 Kotlin 代码 ， 如 图 1.9 所 示 。 


«f MainActivity.kt 





package com.test.myapplication 
3 "import ... 
i class MainActivity : AppCompatActivity() ( 
e override fun onCreate(savedInstanceState: Bundle?) [ 
super.onCreate (savedInstanceState) 


Le setContentView(R.layout.activity main) 
1 1 


图 1.9 
Kotlin 文件 的 添加 方式 与 Java 类 似 , 即 右 击 数据 包 并 选择 New | Kotlin File/Class 命令 ， 

如 图 1.10 所 示 。 
“Me Android Oe I f MainActivity it 


PP 




















v Be manifests 1 package com.test.myapplication 
EÈ Android Manifestxml 2 
v jaa pimport E 
hao lication 


@ Java Class 






€ Main 
> Da comtestmya — Link C++ Project with Gradle 


> Pa comtestmye M, Cut ctl;X ie Android resource file 


图 1.10 
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图 1.10 中 ,IDE 显示 Kotlin File/Class, 而 非 Kotlin class 类 似 于 Java class ), 
其 原因 在 于 ， 单 一 文件 中 定义 了 多 个 成 员 。 第 2 章 将 对 此 予以 详细 解释 。 


需要 注意 的 是 ，Kotlin 源 文件 可 置 于 java 源 文件 夹 中 。 对 此 ， 可 生成 一 个 新 的 Kotlin 
文件 夹 ， 但 此 处 并 非 必需 ， 如 图 1.11 所 示 。 


Bs MyApplication Baapp Bisre B test Bi jova 














manifests 


¥ Di comtestmyapplication 





E f MainActivity 
Š > DI comtestmyapplication (ardrcidTes 
$ > Di com test myapplication (test 
> Reres 
E > © cradle script 


El 1.11 
项 目的 运行 和 调试 与 Java 基本 相同 , 除了 在 项 目 中 配置 Kotlin 之 外 , 并 不 需要 其 他 附 
加 步骤， 如 图 1.12 所 示 。 














Build El Tools vcs Window Help 
€ HP Run ‘opp! FO g 





图 1.12 
É Android Studio 3.0 起 ， 通 过 Android 模板 可 选取 某 种 语言 ， 即 Configure Activity 安 
装 向 导 ， 如 图 1.13 所 示 。 


ff New Android Activity 





Creates a new basic activity with an app bar. 


ActratyName: —— [ssaemem 
= Y 


Layout Name: setivty basket item 
Tie Sesketlem. 
Launcher Activity 
Use a Fragment 
Hierarchical Parent 
Package name: —— |comtestmysppicaton. 


Source Language: | Kotiin 
Target Source Set [main 


图 1.13 
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(3) Java-Kotlin 转换 器 (J2K) 

WA Java 项 目的 移植 操作 也 较为 简单 ， 对 此 ， 可 在 同一 项 目 中 共同 使 用 Java 和 
Kotlin。 通 过 Java to Kotlin converter(J2K)， 存 在 两 种 方式 可 将 现 有 的 Java 代码 转换 为 
Kotlin 代码 。 

第 一 种 方法 是 使 用 convert Java File to Kotlin 命令 将 全 部 Java 文件 转换 为 Kotlin 文件 

(在 Windows 环境 下 ， 人 快捷 键 为 Shift-Alt-Ctrl-K; 在 macOS 环境 下 ， 快 捷 键 为 option+ 
shifttcommand+K)， 该 方法 工作 良好 。 第 二 种 方法 则 是 将 Java 代码 粘贴 至 现 有 的 Kotlin 
文件 中 ， 对 应 代码 也 将 被 转换 (此 时 会 出 现 一 个 包含 转换 提示 信息 的 对 话 框 )。 
如 果 读 者 尚 不 了 解 如 何在 Kotlin 中 编写 特定 代码 , 首先 可 在 Java 中 编写 代码 , 并 于 随 
后 将 其 复制 至 Kotlin 文件 中 。 虽 然 转换 后 的 代码 并 不 是 Kotlin 的 惯用 版 本 , 但 依然 可 正常 
工作 。 同 时 ，IDE 会 显示 多 种 代码 转换 提示 ， 以 改善 代码 的 质量 。 在 转换 前 ， 应 确保 Java 
代码 有 效 ， 另 外 ， 转 换 工 具 易 受到 外 界 影响 ， 即 使 缺失 一 个 分 号 ， 转 换 过 程 也 会 失败 。 基 
于 Java 交互 操作 的 J2K 转换 器 可 将 Kotlin 以 渐进 方式 引入 至 现 有 的 项 目 中 《例如 一 次 转 
换 一 个 类 )。 

(4) 运行 Kotlin 代码 的 蔡 代 方 案 

Android Studio 提供 了 运行 Kotlin 代码 的 替代 方案 , 且 无 须 运 行 Android 应 用 程序 。 当 
对 某 些 Kotlin 代码 (独立 于 较为 耗 时 的 Android 编译 和 部 署 处 理 ) 进行 快速 测试 时 ， 这 一 
方案 十 分 有 用 。 

Kotlin 代码 的 运行 方式 使 用 了 Kotlin REPL， 如 图 1.14 所 示 。 其 中 ，REPL 是 一 种 简单 
的 语言 shell 命令 ， 读 取 单 一 的 用 户 输入 ， 对 其 进行 评估 并 输出 结果 。 

ld Run E VCS Window Help 
=> &__ Tasks & Contexts * Testkt e] > tw B m 
(java 1 Save File as Template... ication» teste) ESSET 
t . Generate JavaDoc... 

IDE Scripting Console 


















































packa P Firebase [s 

© App Links Assistant 

8 Android > 
fun "SEE — Configure kotin in Project 
Configure Kotlin (JavaScript) in Proje 
Configure Kotlin Plugin Updates 
Show Kotlin Bytecode 


Decompile Kotlin To Java 


Kotlin Internal Mode 
Create backup for debugging Kotlin 





图 1.14 
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REPL 类 似 于 命令 行 工具 ， 如 图 1.15 所 示 ， 但 会 提供 全 部 所 需 的 代码 提示 内 容 ， 同 时 
还 可 访问 当前 项 目 中 定义 的 各 种 结构 (例如 类 、 接 口 、 上 层 函 数 等 )。 

















Run eKotlin REPL (in module app) 
G "C:\Program Files\Android\Android Studio 3\jre\bin\java" ... 
Welcome to Kotlin version 1.1.2-4 (JRE 1.8.0_112-release-736) 
2 > Type :help for help, :quit for quit 
Ex 
$ > val color = "Blue" 
3 println(color) 
a Blue 
* RI 
i 
a 
É 
Ai 
* 
(DBRS) Toro itàg:Logcat A Android Profiler [Terminal — BO: Messages 


图 1.15 
速度 是 REPL 的 最 大 优势 ， 因 而 可 快速 对 Kotlin 代码 进行 测试 。 


1.4 Kotlin 底层 机 制 




















虽然 本 书 主要 关注 Android 平台 ， 但 不 应 忘记 ，Kotlin 可 编译 至 多 个 平台 上 。 相 应 地 ， 
Kotlin 可 编译 为 Java 字 节 码 ， 随 后 则 是 Dalvik 字 节 码 。 图 1.16 显示 了 针对 Android 平台 


的 、Kotlin 构建 处 理 过 程 的 简化 版 本 。 









Kotlin 
standard library 






Kotlin 
compiler 
application.apk 





图 1.16 





e 包含 .java 扩展 名 的 文件 包含 Java 代码 。 
e 包含 kt 扩展 名 的 文件 包含 Kotlin 代码 。 
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[在 
用 程 

















Kotlin 标准 
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e 包含 .class 扩展 名 的 文件 包含 Java 字 节 码 。 
e 包含 .dex 扩展 名 的 文件 包含 Dalvik 字 节 码 。 


e 包含 .apk 扩展 名 的 文件 包含 AndroidManifest 文件 、 资 源 文件 以 及 .dex 文件 。 


对 于 纯粹 的 Kotlin 项 目 ， 











序 ， 最 终结 果 将 实现 类 级 别 的 合并 。 





Kotlin 编写 的 应 用 程序 ， 并 在 构建 处 理 过 程 中 自动 添加 至 应 用 程序 中 。 


Æ Kotlin 1.1 中 ,需要 配置 kotlin-runtime 以 运行 Kotlin 编写 的 应 用 程序 。 
实际 上 ，Kotlin 1.1 包含 了 两 种 缺陷 ( kotlin-runtime 和 kotlin-stdlib )， 并 涉及 


0 


发 效 


操作 。 对 此 ， 并 无 相关 语言 可 满足 此 类 条 件 ，JetBrains 最 终 决定 设计 




















仅 使 用 到 Kotlin 项 目 ， 但 Kotlin 也 支持 跨 语言 项 目 。 其 中 ， 
同一 Android 项 目 中 使 用 Kotlin 和 Java。 此 时 ， 两 种 编译 器 均 会 用 于 编译 Android 应 


PE (stdlib〉 是 一 个 小 型 库 ， 并 随同 Kotlin 一 同 发 布 。 该 标准 库 需 要 运行 


多 个 Kotlin 数据 包 , 为 了 减少 混淆 ,kotlin-runtime 和 kotlin-stdlib 在 Kotlin 1.2 


版 本 中 将 合并 至 单一 的 kotlin-stdlib 中 。 自 Kotlin 12 起 ,需要 使 用 到 


kotlin-stdlib 以 运行 Kotlin 编写 的 应 用 程序 。 


Kotlin 标准 库 提 供 了 Kotlin 各 项 工作 所 需 的 必 备 元 素 ， 其 中 包括 : 


e 数组、 集合 、 表 、 范 围 等 数据 类 型 。 

ed E. 

e 高 阶 函 数 。 

e 与 字符 串 和 字符 序列 协同 工作 的 各 种 工具 方法 。 





。JDK 类 扩展 ， 进 而 可 方便 地 与 文件 、IO 以 及 线程 协同 工作 。 


1.5 Kotlin 的 其 他 优势 


Kotlin 针对 JetBrains 提供 了 强 有 力 的 商业 支持 ， 并 对 众多 流行 的 编程 语言 配置 了 IDE 
(Android Studio 基于 JetBrains IntelliJ IDEA). JetBrains 计划 改进 代码 的 质量 以 及 团队 的 开 
率 ， 因 而 须 通过 一 种 语言 解决 Java 中 的 种 种 问题 ， 同 时 提供 与 Java 之 间 的 无 颖 交互 









































己 的 语言 ， 并 启动 





了 Kotlin 项 目 。 目 前 ，Kotlin 应 用 于 其 旗舰 产品 中 。 其 中 ， 一 些 开 发 人 员 结合 Java 进行 
Kotlin 开发 ; 而 另 一 些 开发 者 则 直接 使 用 Kotlin 产品 。 
Kotlin 是 一 门 十 分 成 熟 的 语言 ， 实 际 上 ， 该 语言 于 多 年 之 前 即 已 出 现 ， 随 后 Google 














官方 宣布 ，Android 对 Kotlin 予以 支持 (2010 4E 11 H 8 











日 )， 如 


图 











1.17 所 示 。 
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Start Open Released Official Android 
Development sourced 1.01-1.07 suppot announced 


v v v v 
A A A 


JetBrains unveiled Released 1.0 Released 1.1 
Project Kotlin 


E 147 


Jet 则 是 Kotlin 语言 的 最 初 名 称 。 后 来 ，JetBrains 团队 确定 将 其 更 名 为 
i) Kotlin, 该 名 称 源 自 圣彼得堡 附近 的 科 特 宁 岛 ， LF Java 取 名 于 印度 尼 西 
亚 的 爪哇 岛 


Kotlin 1.0 版 本 于 2016 年 发 布 ， 随 后 ， 越 来 越 多 的 公司 开始 支持 Kotlin 项 目 。 其 中 ， 
Gradle 添加 了 对 Kotlin 的 脚本 支持 ; 作为 一 家 最 大 的 Android 库 开 发 商 , Square 也 对 Kotlin 
提供 了 大 力 支持 ;最 终 ，Google 宣布 在 Android 平台 上 对 Kotlin 予以 支持 。 这 也 意味 着 ， 
Android 发 布 的 每 一 项 工具 均 兼 容 于 Java 和 Kotlin. Google 和 JetBrains 最 终 达 成 合作 关系 ， 
FAET Kotlin 非 营利 组 织 ， 负 责 该 语言 的 维护 和 开发 。 所 有 努力 旨 在 推动 Kotlin 语言 
市 场 份额 。 

Kotlin 类 似 于 Apple 公司 推出 的 Swift 编程 语言 。 实 际 上 ， 二 者 间 具 有 很 多 相似 之 处 ， 
许多 文章 着 重 分 析 了 两 种 语言 之 间 的 差异 性 (而 非 相似 性 )。 对 于 渴望 学 习 Android fil iOS 
应 用 程序 开发 的 人 士 来 讲 ，Kotlin 语言 是 一 种 较 好 的 选择 方案 。 另 有 计划 表明 ，Kotlin 以 
后 可 导入 至 iOS (Kotlin/Native) 中 ， 或 许 学 习 Swift 语言 将 不 再 必需 。 另 外 ，Kotlin 还 可 
实现 全 栈 开 发 ， 因 而 可 开发 服务 器 端 应 用 程序 ， 以 及 前 端 客户 端 应 用 程序 ， 并 在 移动 客户 
端 上 共享 同一 数据 模型 。 





























L6 本 章 小 结 


本 章 讨 论 了 Kotlin 语言 与 Android 开发 之 间 的 关系 ， 以 及 Kotlin 与 现 有 项 目 之 间 的 整 
合 方式 。 另 外 ， 本 章 还 考察 了 相关 示例 ， 并 展示 了 Kotlin 语言 的 简洁 性 和 安全 性 。 

第 2 章 主 要 学 习 Kotlin 语言 的 构造 模块 ， 以 及 使 用 Kotlin 语言 开发 Android 应 用 程序 
时 须 具 备 的 基础 知识 。 


第 2 章 Kotlin 语言 基础 知识 


本 章 主要 讨论 基本 构建 模块 ， 这 也 是 Kotlin 语言 中 的 核心 元 素 。 每 一 个 模块 自身 并 不 
具备 太 多 含义 ， 经 适当 组 合 后 ， 即 可 创建 功能 强大 的 语言 结构 。 本 章 将 探讨 Kotlin 语言 的 
类 型 机 制 ， 并 介绍 严格 的 空 保护 以 及 智能 转换 机 制 。 除 此 之 外 ， 还 将 考察 JVM 中 的 一 些 
新 增 操作 符 。 与 Java 语言 相 比 ，Kotlin 提供 了 多 种 改进 措施 。 同 时 ， 本 章 还 将 阐述 最 新 的 
应 用 程序 控制 流 方法 ， 并 采用 统一 方式 处 理 等 式 问题 。 

本 章 主 要 涉及 以 下 内 容 : 

。 变量 、 值 和 常量 。 

e 类 型 推断 。 

e 严格 的 空 安全 机 制 。 

e 智能 转换 。 

e Kotlin 数据 类 型 。 

e 控制 结构 。 

o 异常 处 理 。 























在 Kotlin 语言 中 ， 定 义 了 两 种 变量 类 型 : var 或 val。 其 中 ，var 表示 为 可 变 引 用 CH. 
备 读 一 写 功能 )， 并 可 在 初始 化 后 更 新 ; var 关键 字 可 用 于 定义 Kotlin 中 的 变量 ， 也 等 价 于 
常规 的 Java 变量 。 如 果 变 量 在 某 一 时 刻 发 生变 化 ， 应 采用 var 关键 字 对 其 进行 声明 。 下 列 
示例 展示 了 变量 的 声明 过 程 : 


fun main(args: Array<String>) { 
var fruit:String - "orange" // 1 
fruit - "banana" // 2 








} 


其 中 : 

e 定义 fruit 变量 ， 并 利用 orange 变量 值 对 其 进行 初始 化 。 

e 利用 banana 值 再 次 初始 化 fruit 变量 。 

第 二 种 变量 类 型 表示 为 只 读 引 用 ， 该 变量 类 型 在 初始 化 后 无 法 重新 赋值 。 
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val 关键 字 可 包含 自 定 义 getter 方法 , 因而 从 技术 角度 上 讲 , 可 在 每 次 访 
问 后 返回 不 同 的 对 象 。 换 而 言 之 ， 无 法 保证 底层 对 象 引用 是 不 可 变 的 。 

val random: Int 

get() = Random().nextInt() 


第 4 章 将 深入 讨论 自 定义 getter 方法 。 


val 关键 字 等 同 于 包含 final 修饰 符 的 Java 变量 。 不 可 变 变量 的 功效 在 于 ， 可 确保 变量 
不 被 错误 地 修改 。 另 外 ， 当 与 多 线程 协同 工作 时 ， 不 可 变性 同样 十 分 有 用 ， 且 不 必 担 心 相 
应 的 数据 同步 操作 。 当 声明 不 可 变 变 量 时 ， 可 使 用 val 关键 字 ， 如 下 所 示 : 
fun main(args: Array<String>) ( 
val fruit:String- "orange"// 1 


fruit = "banana" // 2 Error 
) 


e 定义 fruit 变量 ， 并 利用 orange 字符 串 值 对 其 进行 初始 化 。 
o 此 时 编译 器 将 抛 出 一 条 错误 一 一 fruit 变量 已 经 被 初始 化 。 





0 Kotlin 还 可 定义 文件 级 别 的 变量 和 函数 ， 详 细 内 容 将 在 第 3 章 讨论 。 





需要 注意 的 是 ， 变 量 引用 类 型 (var，val) 与 其 自身 引用 相关 ， 而 不 是 引用 对 象 的 
属性 。 这 也 表明 ， 当 使 用 只 读 引 用 (val) 时 ,将 无 法 改变 指向 特定 对 象 实例 的 引用 (无 
法 再 向 变量 赋值 )， 但 仍 可 修改 引用 对 象 的 属性 。 下 面 通过 数组 方式 对 此 加 以 考察 。 


val list = mutableListOf("a","b","c") // 1 
list = mutableListOf("d", "e") // 2 Error 
list.remove("a") // 3 


e 初始 化 可 变 列 表 。 

e 此 时 编译 器 将 抛 出 一 条 错误 一 一 值 引 用 无 法 被 修改 〈 重 新 赋值 )。 

e 编译 器 允许 修改 当前 列表 中 的 内 容 。 

关键 字 val 无 法 保证 底层 对 象 不 可 变 。 

如 果 须 保证 当前 对 象 不 可 被 修改 ， 则 应 使 用 不 可 变 引 用 以 及 一 个 不 可 变 对 象 。 然 
而 ，Kotlin 标准 库 包 含 了 一 个 集合 接口 的 不 可 变 等 价 结构 (List 和 MutableList, Map 和 
MutableMap 等 ); 同样 ， 对 于 创建 特定 集合 实例 的 帮助 函数 也 是 如 此 ， 如 表 2.1 所 示 。 
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表 2.1 
变量 / 值 定义 对 象 状态 是 否 可 变 
val = listOf(1,2,3) 否 
val = mutableListOf(1,2,3) 是 
var = listOf(1,2,3) 否 
var = mutableListOf(1,2,3) 是 


22 类 型 推断 


通过 上 述 示例 可 以 看 出 ，Kotlin 类 型 定义 在 变量 名 称 之 后 ， 这 一 点 与 Java 不 同 ， 如 下 
所 示 : 
var title: String 


初 看 之 下 ，Java 程序 员 可 能 会 感到 奇怪 ,但 这 种 定义 方式 则 是 Kotlin 中 非常 重要 的 特 
征 之 一 ， 即 类 型 推断 。 类 型 推断 意味 着 ,编译 器 可 从 上 下 文中 推断 类 型 (赋予 某 个 变量 的 
表达 式 值 )。 当 变量 声明 和 初始 化 工作 一 起 执行 时 ， 即 可 省 略 类 型 声明 。 考 察 下 列 变量 定 
义 : 

var title: String = "Kotlin" 


Heh, ZH title 的 类 型 为 Sting， 但 是 否 真正 需要 一 个 隐 式 类 型 声明 以 确定 变量 类 型 ? K 
达 式 右 侧 表示 为 字符 串 Kotlin， 可 将 其 赋予 表达 式 左 侧 所 定义 的 变量 title。 

显然 ,此 处 将 变量 类 型 定义 为 String, 这 与 赋值 表达 式 (Kotlin) 具有 相同 类 型 。 同样， 
Kotlin 编译 器 也 知晓 这 一 事实 ， 因 此 当 声 明 某 个 变量 时 ， 可 省 略 相关 类 型 。 针 对 源 自 当前 
上 下 文 的 变量 ， 编 译 器 会 尝试 确定 最 佳 类 型 ， 如 下 所 示 : 


var title = "Kotlin" 


需要 注意 的 是 ,此 处 虽 省 略 了 类 型 声明 , 但 变量 类 型 仍 隐 式 地 设置 为 String 一 一 Kotlin 
是 一 种 强 类 型 语言 。 这 也 解释 了 上 述 两 项 声明 彼此 相同 的 原因 ，Kotlin 编译 器 仍 可 验证 全 
部 变量 的 特征 应 用 。 相 关 示 例如 下 所 示 : 

var title = "Kotlin" 

title = 12 // 1, Error 
其 中 ， 推 断 类 型 为 String， 而 此 处 尝试 赋予 Int。 

如 果 希 望 像 title 变量 赋值 mt (对 应 值 为 12)， 则 须 将 title 类 型 定义 为 String 和 常见 类 
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型 Int， 在 类 型 体系 结构 中 ， 最 为 接近 的 结果 是 Any， 如 下 所 示 : 


var title: Any = "Kotlin" 
title - 12 


Any 等 价 于 Java 中 的 对 象 类 型 ， 同 时 也 是 Kotlin 类 型 体系 结构 中 的 根 节 点 ， 如 图 2.1 
所 示 。Kotlin 中 的 全 部 类 显 式 地 继承 自 Any 类 型 ， 甚 至 是 String 或 Int 等 基本 类 型 。 











String] | Int 
图 2.1 











Any 定义 了 3 种 方法 ， 分 别 是 equals、toString 和 hashCode. Kotlin 标准 
库 针 对 该 类 型 设置 了 一 些 扩展 ， 第 7 章 将 对 此 加 以 讨论 。 

不 难 发 现 ， 类 型 推断 不 仅 限 于 基本 类 型 ， 下 面 考察 直接 源 自 函 数 的 推断 类 型 。 

var total = sum(10, 20) 
在 该 示例 中 ,推断 类 型 等 同 于 函数 的 返回 类 型 ,此 处 可 猜测 为 Int 类 型 ,但 也 可 能 是 Double. 
Float 或 其 他 类 型 。 如 果 难 以 从 上 下 文中 推断 相应 类 型 ， 则 可 单 击 变量 名 ， 并 运行 Android 
Studio 表达 式 类 型 命令 CLE Windows 中 ， 为 Shift+Ctrl+P 快捷 键 ， 在 macos 中 ， 为 箭头 
+controltP)， 并 以 工具 提示 方式 显示 相应 的 变量 类 型 ， 如 图 2.2 所 示 。 














Int 


图 2.2 
类 型 推荐 机 制 同样 适用 于 泛 型 ， 如 下 所 示 : 


var persons = listOf(personInstancel, personInstance2) 
// Inferred type: List«Person» () 


假设 仅 传递 Person 类 实例 , 则 推断 类 型 为 List<Person>。 另 外 ,listOf 方法 是 定义 于 Kotlin 
标准 库 中 的 帮助 函数 ， 并 可 创建 集合 ， 第 7 章 将 对 此 加 以 讨论 。 下 面 考察 相对 高 级 的 示 
例 ， 并 使 用 称 之 为 Pair 的 Kotlin 标准 库 类 型 ， 其 中 包含 了 由 两 个 数值 组 成 的 二 元 对 ， 如 
下 所 示 : 


var pair = "Everest" to 8848 // Inferred type: Pair<String, Int» 























532% Kotlin 语言 基础 知识 “23。 





其 中 ，pair 实例 通过 中 级 函数 创建 ， 第 4 章 将 对 此 进行 解释 。 当 前 ， 读 者 仅 须 了 解 两 个 声 
明 均 返回 相同 的 Pair 对 象 类 型 ， 如 下 所 示 : 

var pair = "Everest" to 8848 

// Create pair using to infix method 


var pair2 = Pair("Everest", 8848) 
// Create Pair using constructor 


类 型 推断 还 适用 于 更 为 复杂 的 场合 ， 例 如 从 推断 类 型 中 进行 类 型 的 推断 。 下 面 使 用 

Kotlin 标准 库 中 的 mapOf 函数 ， 以 及 Pair 类 中 的 to 方法 定义 map。 其 中 ， 二 元 对 中 的 第 
项 用 于 推断 map 键 类 型 ， 第 二 项 用 于 推断 值 类 型 ， 如 下 所 示 : 

var map = mapOf("Mount Everest" to 8848, "K2" to 4017) 

// Inferred type: Map<String, Int» 

Map<String, Int> 的 泛 型 根据 Pair<String, Int> 进 行 推断 ， 也 就 是 说 , 根据 传递 至 Pair 构 
造 方法 中 的 参数 类 型 进行 推断 。 这 里 , 读者 可 能 会 产生 疑问 : 如 果 用 于 创建 map 的 二 元 对 
彼此 不 同 ， 情 况 又 当 如 何 ? 此 处 ， 第 一 个 二 元 对 表示 为 Pair<String,Int>， 第 二 个 二 元 对 表 
示 为 Pair<String, String>， 如 下 所 示 : 















































var map = mapOf ("Mount Everest" to 8848, "K2" to "4017") 

// Inferred type: Map<String, Any» 
其 中 ，Kotlin 编译 器 针对 全 部 二 元 对 尝试 推断 基本 类 型 。 两 个 二 元 对 中 的 第 一 个 参数 表示 
为 String (Mount Everest，K2)。 自 然 地 ， 此 处 推断 类 型 为 String。 二 元 对 中 的 第 二 个 参数 
则 有 所 不 同 (第 一 个 二 元 对 为 nt, 第 二 个 二 元 对 为 String)。 因 此 ，Kotlin 须 获取 最 近 的 基 
本 类 型 。 由 于 上 行 类 型 体系 结构 中 最 近 的 基本 类 型 为 Any， 因 而 此 处 选择 了 Any 类 型 ， 如 
图 2.3 所 示 。 
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不 难 发 现 ， 类 型 推断 机 制 在 大 多 数 时 候 工作 良好 ， 但 必要 时 ， 仍 可 选择 显 式 定义 某 种 
数据 类 型 。 例 如 需要 定义 不 同 的 变量 类 型 时 : 


var age: Int = 18 
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当 处 理 整 数 时 ，Int 类 型 通常 是 默认 选择 ， 但 依然 可 显 式 地 定义 不 同类 型 ， 例 如 Short, HE 
而 节省 Android 内 存 空 间 ， 如 下 所 示 : 


var age: Short = 18 


另外 一 方面 ， 如 果 和 希望 存储 较 大 的 数值 ， 可 将 age 的 变量 类 型 定义 为 Long。 如 前 所 述 ， 可 
采用 显 式 类 型 声明 ， 或 者 使 用 字面 常量 ， 如 下 所 示 : 

var age: Long = 18 // Explicitly define variable type 

var age = 18L 

// Use literal constant to specify value type 
上 述 两 项 声明 具有 相同 效果 ， 均 可 生成 Long 类 型 的 变量 。 

代码 中 常会 遇 到 省 略 类 型 声明 ， 以 使 语法 更 为 简洁 。 但 在 某 些 场合 下 ， 由 于 上 下 文 环 
境 缺 失 ，Kotlin 编译 器 无 法 进行 类 型 推断 。 例 如 ， 不 包含 赋值 行为 的 简单 声明 往往 会 导致 
类 型 推断 失败 ， 如 下 所 示 : 


val title // Error 


其 中 ， 变 量 将 于 后 续 操作 中 进行 初始 化 ， 因 而 目前 尚 无 法 确定 其 类 型 ， 这 也 是 类 型 须 显 式 
定义 的 原因 。 一 般 的 规则 是 ， 如 果 表 达 式 类 型 针对 编译 器 已 知 ， 则 可 对 类 型 进行 推断 ， 否 
则 ， 需 要 对 其 进行 显 式 定义 。Android Studio 中 的 Kotlin 在 这 一 方面 表现 得 较 好 ， 并 可 对 
类 型 推断 错误 之 处 予以 高 亮 显示 。 也 就 是 说 ， 在 编写 代码 时 ，IDE 可 即时 显示 相应 的 错误 


信息 。 




































































2.3 严格 的 空 保护 机 制 


根据 敏捷 软件 评估 (对 应 网 址 为 http://p3.snf.ch/Project-144126) 结果 显示 ， 在 Java 系 
统 中 ， 空 安全 检测 是 最 为 常见 的 问题 之 一 。 在 Java 中 ， 最 大 的 问题 在 于 NullPointer 
Exception. 

为 了 避免 NullPointerException， 需 要 编写 相应 的 防护 代码 ， 并 检测 某 一 对 象 在 使 用 前 
是 否 为 空 。 大 多 数 现代 编程 语言 通过 相关 步骤 将 运行 期 错误 转化 为 编译 期 错误 , 例如 Kotlin 
语言 。 在 Kotlin 中 ， 一 种 方式 是 向 语言 类 型 系统 中 添加 空 保护 机 制 。Kotlin 类 型 系统 可 辨 
识 空 引用 以 及 非 空 引用 。 该 特性 在 开发 的 各 个 阶段 均 可 检测 与 NullPointer Exception 相关 
的 错误 。 编译 器 以 及 IDE 均 会 阻止 NullPointerException。 在 大 多 数 时 候 ， 程 序 将 产生 编译 
期 错误 ， 而 非 运行 期 错误 。 

空 保护 机 制 隶 属于 Kotlin 的 类 型 系统 。 默 认 状态 下 , 常规 类 型 通常 无 法 设置 为 空 值 (无 
法 存储 空 引 用 )， 除 非 对 其 予以 显 式 定义 。 当 存储 空 引 用 时 ， 需 要 标记 可 空 变量 (可 存储 
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空 引 用 )， 即 在 变量 类 型 声明 中 添加 问号 ， 如 下 所 示 : 

val age: Int = null // 1, Error 

val name: String? = null // 2 
针对 第 一 行 代码 ， 编 译 器 将 抛 出 错误 消息 一 一 该 类 型 不 可 为 空 。 在 第 二 行 代码 中 ， 可 执行 
空 赋值 操作 一 一 该 类 型 采用 问号 后 级 标记 为 可 空 。 

对 于 潜在 空 对 象 ， 将 无 法 调用 其 中 的 方法 ， 除 非 在 调用 前 进行 检测 ， 如 下 所 示 : 

val name: String? = null 

Uses 

name.toUpperCase() // error, this reference may be null 

稍 后 将 讨论 如 何 解决 此 类 问题 。Kotlin 语言 中 的 非 空 类 型 均 包含 空 类 型 的 等 价 形式 ， 
例如 Int 和 Int?，String 和 String? 等 。 同 样 的 规则 也 适用 于 Android 框架 中 的 所 有 类 (例如 
View Ñl View? )。 这 也 表明 , 各 种 非 泛 型 类 均 可 用 于 定义 两 种 类 型 , 即 空 类 型 和 非 空 类 型 。 
同时 ， 非 空 类 型 也 可 表示 为 其 空 等 价 形式 的 子 类 型 。 例 如 ，Vehicle (也 是 Vehicle? 的 子 类 
型 ) 也 可 表示 为 Any 的 子 类 型 ， 如 图 2.4 所 示 。 








































图 2.4 
其 中 ，Nothing 类 型 表示 为 一 种 空 类 型 ， 且 无 法 生成 相应 的 实例 。 第 3 章 将 对 此 加 以 深入 
讨论 。 根 据 这 一 类 型 体系 结构 ， 可 将 非 空 对 象 (Vehicle) 赋予 至 可 空 类 型 变量 (Vehicle? )， 
但 却 不 可 将 可 空 对象 (Vehicle?) 赋予 至 非 空 变量 (Vehicle)， 如 下 所 示 : 
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var nullableVehicle: Vehicle? 
var vehicle: Vehicle 


nullableVehicle = vehicle // 1 
vehicle - nullableVehicle // 2, Error 


在 第 3 行 代码 中 ， 可 执行 赋值 操作 ; 而 在 第 4 行 代码 中 ， 由 于 nullableVehicle 可 能 
因而 将 会 产生 错误 。 
章节 将 继续 探讨 可 空 类 型 ， 下 面 再 次 返回 类 型 定义 。 当 定义 泛 型 时 ， 存 在 多 种 可 



































空 类 型 的 定义 方式 。 对 于 泛 型 (其 中 包含 了 Int 类 型 的 数据 项 )， 表 2.2 通过 比较 
不 同 的 声明 方式 ， 检 测 各 种 集合 
表 2.2 
类 型 声明 元 素 是 否 可 为 空 

ArrayList<Int> "m 

ArrayList<Int>? f 

ArrayList<Int?> 是 

ArrayList<Int?>? 是 








由 于 编译 器 会 强制 消除 NullPointerException， 因 此 读者 应 深入 理解 空 类 型 声明 的 不 同 
方式 。 这 也 表明 ， 在 访问 潜在 的 空 引用 之 前 ， 编 译 器 将 执行 空 检测 。 下 面 考察 Activity 类 
onCreate 中 的 常见 Android/Java 错误 。 




















// Java 

GOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
savedInstanceState.getBoolean ("locked"); 


H 
在 Java 中 ， 代 码 将 成 功 编译 ， 访 问 空 对 象 将 导致 应 用 程序 在 运行 期 内 崩溃 ， 同 时 抛 出 
NullPointerException。 下 面 查看 该 方法 的 Kotlin 版 本 。 


override fun onCreate(savedInstanceState: Bundle?) { // 1 
super.onCreate (savedInstanceState) 
savedInstanceState.getBoolean("key") // 2 Error 








2; 


JB, savedInstanceState 定义 为 Bundle?。 此 时 ， 编 译 器 将 抛 出 错误 消息 
savedInstanceState 是 一 种 平台 类 型 ，Kotlin 可 将 其 PER ier seas, 稍 后 将 
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讨论 平台 类 型 ， 当 前 仅 将 savedInstanceState 定义 为 可 空 变量 一 一 首次 创建 Activity 时 ， 将 
会 传递 空 值 。 当 采用 保存 后 的 实例 状态 再 次 创建 Activity 时 ， 仅 传递 Bundle 实例 。 




















qp 第 3 章 将 讨论 函数 。 目 前 ，Kotlin 中 函数 的 声明 方式 与 Java 十 分 类 似 。 


在 Kotlin 中 ， 空 类 型 检测 方式 与 Java 基本 相同 。 


override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate (savedInstanceState) 
y 


override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate (savedInstanceState) 


val locked: Boolean 
if(savedInstanceState !- null) 
locked - savedInstanceState.getBoolean ("locked") 
else 
locked = false 
) 





在 Java 开发 过 程 中 ， 空 检测 是 一 类 十 分 常见 的 操作 (特别 是 在 Android 框架 中 ， 其 中 大 部 


分 元 素 均 为 可 空 )。 然 而 ，Kotlin 支持 更 为 简单 的 操作 ， 进 而 处 理 可 空 变量 ， 
其 中 之 一 。 


2.3.1 安全 调用 





安全 调用 便 是 


安全 操作 符 表 示 为 一 个 问号 和 “.” 的 组 合 。 注 意 ， 安 全 转换 操作 符 总 是 返回 某 个 值 。 


如 果 操 作 符 左 侧 为 null， 则 返回 null， 和 否则 将 返回 右 侧 表达 式 结果 。 


override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate (savedInstanceState) 








val locked: Boolean? - savedInstanceState?.getBoolean ("locked") 


) 





如 果 savedInstanceState 为 null， 则 结果 返回 null; 否则 ， 将 返回 savedInstanceState?. 





getBoolean("locked") 表 达 式 的 结果 。 需 要 注意 的 是 ， 可 空 引用 调用 总 是 返回 


可 空 结果 ， 因 

















此 ， 表 达 式 整体 结果 表示 为 可 空 的 Boolean?。 若 希望 获得 非 空 的 布尔 值 ， 见 
操作 符 和 elvis 操作 符 结合 使 用 ， 稍 后 将 对 此 加 以 讨论 。 











可 将 安全 调 | 
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多 次 调用 安全 调用 操作 符 可 形成 链 式 效果 ,从 而 可 避免 使 用 内 区 过 表达 式 或 一 些 较为 
复杂 的 条 件 ， 如 下 所 示 : 

// Java idiomatic - multiple checks 

val quiz: Quiz - Quiz() 

ji ees 

val correct: Boolean? 

















豆 


if(quiz.currentQuestion != null) ( 
if(quiz.currentQuestion.answer !- null ) ( 
// do something 
) 


) 
// Kotlin idiomatic - multiple calls of save call operator 


val quiz: Quiz = Quiz() 
aos 


val correct = quiz.currentQuestion?.answer?.correct 
// Inferred type Boolean? 


其 中 ， 链 式 效果 的 工作 方式 可 描述 为 : 仅 当 answer 值 非 null， 方 可 访问 correct; 仅 当 
currentQuestion 值 非 null, answer 方 可 被 访问 。 最 终 ， 表 达 式 将 返回 correct 属性 的 返回 值 ; 
或 者 ， 如 果 安 全 调用 链 中 的 任意 对 象 均 为 null， 则 返回 null. 


2.3.2 elvis 操作 符 


elvis 操作 符 采 用 问号 和 冒号 组 合 显示 ， 即 “?:”， 对 应 语法 显示 如 下 所 示 : 

first operand ?: second operand 
其 工作 方式 可 描述 为 : 如果 第 一 个 操作 数 不 为 null， 则 返回 该 操作 数 ， 否 则 返回 第 二 个 操 
作 数 。 通 过 elvis 操作 符 ， 读 者 可 编写 更 为 简洁 的 代码 。 

当 使 用 elvis 操作 符 时 ， 将 获得 非 空 的 locked 变量 ， 如 下 所 示 : 

override fun onCreate(savedInstanceState: Bundle?) ( 


super.onCreate (savedInstanceState) 
val locked: Boolean - savedInstanceState?.getBoolean("locked") ?: false 


H 


在 上 述 代码 中 ， 如 果 savedInstanceState JEF, elvis 操作 符 将 返回 savedInstanceState?. 
getBoolean("locked") 表 达 式 ; 否则 ， 将 返回 false。 该 方式 可 确保 正确 处 理 locked 变量 。 根 
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Hi elvis 操作 符 , 还 可 定义 默认 值 。 另外 , 仅 当 左 侧 结果 为 null, 方 进一步 计算 右 侧 表达 式 。 
随后 ， 当 表达 式 为 空 时 ， 将 提供 相应 的 默认 值 。 对 此 ， 可 适当 调整 2.3.1 节 中 的 示例 代码 ， 
以 使 其 总 是 返回 非 空 值 ， 如 下 所 示 : 


val correct = quiz.currentQuestion?.answer?.correct ?: false 


最 终 ， 表 达 式 将 返回 correct 属性 的 返回 值 ， 或 者 ， 如 果 安 全 调用 链 中 的 任何 对 象 为 null， 
则 结果 返回 false。 这 也 意味 着 ， 对 应 值 总 会 被 返回 ， 因 此 推断 结果 表示 为 非 空 的 布尔 值 。 


qp elvis 操作 符 的 名 称 源 自 美国 著名 歌手 Elvis Presley ( 埃 尔 维 斯 ， 普 菜 斯 
利 )， 其 发 型 像 是 一 个 大 大 的 问号 ， 如 图 2.5 所 示 。 


















































2.8.8 dE TE 


非 空 断言 则 是 另 一 种 空 检测 工具 ， 并 采用 两 个 问号 表示 。 该 操作 符 显 式 地 将 可 空 变量 
转换 为 非 空 变量 ， 如 下 所 示 : 
var y: String? = "foo" 
var size: Int = y!!.length 
正常 情况 下 ， 无 法 将 某 个 值 从 可 空 属性 length 赋予 非 空 变量 size 中 。 然 而 ， 此 处 可 明确 告 
知 编译 器 : 当前 可 空 变量 可 包含 一 个 值 。 如 果 这 一 结论 正确 ， 应 用 程序 即 可 以 正确 方式 工 
E: 和 否则， 变量 将 包含 null 值 ， 应 用 程序 将 抛 出 NullPointerException。 下 面 考察 onCreate 
方法 中 的 对 应 操作 。 
override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate (savedInstanceState) 
val locked: Boolean = savedInstanceState!!.getBoolean ("locked") 
) 
上 述 代 码 可 进行 编译 ， 但 是 否 可 正常 地 工作 ? 如 前 所 述 ， 当 恢复 某 个 操作 实例 时 ， 
savedInstanceState 将 传递 至 onCreate 方法 中 。 因 此 ， 当 前 代码 正常 工作 且 不 会 抛 出 异常 。 
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然而 ， 若 生成 操作 实例 时 savedInstanceState 为 null (不 存在 之 前 的 实例 可 供 恢复 )， 因 而 
将 在 运行 期 内 抛 出 NullPointerException。 这 一 行为 与 Java 类 似 ， 二 者 间 的 主要 差别 在 于 ， 
在 Java F, 访问 潜在 可 空 对 象 且 未 经 过 空 检测 可 视 为 一 种 默认 行为 : 而 在 Kotlin H, 则 须 
对 此 予以 强制 执行 ， 否 则 将 产生 编译 错误 。 

该 操作 符 仅 存在 少量 的 正确 应 用 场合 。 因 此 ， 当 在 代码 中 使 用 或 查看 非 空 断言 时 ， 须 
注意 其 潜在 的 危险 和 警告 。 此 处 建议 ， 应 尽量 减少 其 使 用 频率 ， 在 大 多 数 时 候 ， 可 采用 安 
全 调用 智能 转换 。 

http://bit.ly/2xg5JXt 中 提供 了 少量 的 可 用 示例 。 其 中 , 非 空 断言 操作 符 被 
其 他 操作 符 所 替代 ， 进 而 保证 正确 的 Kotlin 结构 。 


实际 上 ， 上 述 示例 并 无 必要 使 用 非 空 断言 操作 符 ; 相反 ， 可 通过 更 加 安全 的 方式 处 理 
这 一 问题 ， 即 let。 


2.3.4 let 



























































let 是 另 一 种 可 空 变量 的 处 理 方式 。 实 际 上 ，let 并 非 是 一 类 操作 符 ， 同 时 也 不 是 一 种 
特定 的 语言 结构 。let 是 Kotlin 标准 库 中 所 定义 的 一 个 函数 。 下面 结 合 安全 调用 操作 符 对 let 
的 语法 加 以 考察 。 

override fun onCreate(savedInstanceState: Bundle?) ( 

super.onCreate (savedInstanceState) 


savedInstanceState?.let( 
println(it.getBoolean("isLocked")) // 1 
) 
) 


let 中 的 savedInstanceState 可 通过 命名 变量 进行 访问 。 

如 前 所 述 ， 如 果 左 侧 Eric 非 null， 则 可 计算 安全 调用 操作 符 的 右 侧 表达 式 。 在 当前 示 
例 中 ,， 右 侧 表示 为 let 函数 ， 并 接收 另 一 个 函数 (Lambda) 作为 参数 。 当 savedInstanceState 
不 为 null 时 ， 将 执行 let 之 后 的 代码 块 中 的 代码 。 关 于 函数 ， 第 7 章 将 对 此 加 以 介绍 。 





24 可 空 性 和 Java 





前 述 内 容 讨 论 了 Kotlin 中 须 显 式 定 义 包含 null 值 的 引用 。 另 外 一 方面 ，Java 对 此 则 并 
不 十 分 严格 。 这 里 的 问题 是 ，Kotlin 如 何 处 理 来 自 Java 中 的 数据 类 型 (基本 上 讲 ， 全 部 
Android SDK 和 库 均 采用 Java 编写 ) ? 无 论 如 何 ，Kotlin 编译 器 都 将 根据 代码 确定 类 型 的 
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可 空 性 ， 并 通过 可 空 标注 ， 将 类 型 表示 为 可 空 或 非 空 类 型 。 


Kotlin 编译 器 支持 多 种 可 空 标注 形式 ， 其 中 包括 : 
e Android ( com.android.annotations 和 android.support.annotations ). 
Q e JetBrains ( # É org.jetbrains.annotations 包 的 @Nullable 和 @NotNull ). 





e JSR-305 ( Javax.annotation ). 
读者 可 访问 https//github. com/ JetBrains/ kotlin/ blob/ master/ core/ 
descriptor. loader.Java/src/ org/jetbrains/kotlin/load/Java/JvmAnnotationNames.kt 
以 查看 Kotlin 编译 器 的 完整 源 代 码 。 
在 Activity 类 的 onCreate 方法 中 ，savedInstanceState 类 型 显 式 地 设置 为 可 空 类 型 
Bundle?， 如 下 所 示 : 


override fun onCreate(savedInstanceState: Bundle?) { 


} 

然而 , 也 存在 某 些 场合 无 法 确定 变量 的 可 空 性 ,除了 标记 为 不 可 空 类 型 之 外 , 源 自 Java 
的 全 部 变量 均 可 为 null。 相 应 地 , 可 将 其 全 部 视 为 可 空 类 型 ,并 在 每 次 访问 之 前 予以 检测 ， 
但 该 行为 缺乏 实际 操作 意义 。 针对 这 一 问题 , Kotlin 引入 了 平台 类 型 这 一 概念 , 且 源 于 Java 
类 型 ， 并 包含 了 相对 宽松 的 null 检查 。 这 也 意味 着 ， 平 台 类 型 可 以 为 null RER. 

尽管 无 法 亲自 声明 平台 类 型 , 这 一 特殊 语法 的 存在 原因 在 于 , 编译 器 和 Android Studio 
某 些 时 候 需 要 对 其 加 以 显示 。 对 此 ， 可 将 平台 类 型 置 于 异常 消息 或 方法 参数 列表 中 。 在 变 
量 类 型 声明 中 ， 平台 类 型 语法 仅 表示 为 一 个 单一 的 感叹 号 后 级 ， 如 下 所 示 : 


View! // View defined as platform type 


各 种 平台 类 型 均 可 视 为 可 空 类 型 ， 但 类 型 的 可 空 机 制 通常 取决 于 上 下 文 。 因 此 ， 某 些 
时 候 可 将 其 视 为 非 空 变量 。 下 列 伪 代 码 显 示 了 平台 类 型 的 可 能 含义 。 

ER 

开发 人 员 负 责 处 理 如 何 定义 相关 类 型 〈 可 空 或 不 可 空 )。 下 面 考 察 findViewByld 方法 
中 的 具体 应 用 。 

val textView = findViewById(R.id.textView) 
对 此 ， 相 关 问 题 包括 : findViewByld 方法 的 实际 返回 内 容 ，textView 的 推断 类 型 ， 可 空 
类 型 (TestView) 或 是 不 可 空 类 型 (TestView?) ? RURA F, Kotlin 编译 器 对 于 
findViewById 方法 返回 值 的 可 空 性 一 无 所 知 。 这 也 是 TextView 的 推断 类 型 包含 平台 类 型 
TextView! 的 原因 。 
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由 于 程序 员 了 解 布 局 中 是 否 包含 所 配置 的 TextView 〈 横 向、 纵向 等 )， 因 而 应 负责 处 
理 此 类 事项 ,或 其 中 的 部 分 内 容 。 若 在 当前 布局 中 定义 了 适宜 的 视图 ，findViewByld 方法 
将 返回 该 视图 的 引用 ， 否 则 将 返回 null， 如 下 所 示 : 


val textView 
val textView 





























findViewById(R.id.textView) as TextView // 1 
findViewById(R.id.textView) as TextView? // 2 
针对 第 一 行 代码 ， 假 设 textView 出 现 于 每 项 配置 的 各 个 布局 中 , 因此 text View 可 定义 为 不 
可 空 类 型 。 在 第 二 行 代码 中 ， 假 设 textView 未 出 现 于 全 部 布局 配置 中 (例如 仅 出 现 于 横向 
模式 中 )，textView 须 定义 为 可 空 类 型 ， 和 否则 ， 当 尝试 向 某 一 非 空 变量 赋值 null 时 〈 载 入 
未 包含 textView 的 布局 )， 将 会 抛 出 NullPointerException. 
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大 多 数 编程 语言 均 支 持 数据 转换 这 一 概念 。 基 本 上 讲 ， 转 换 是 指 将 某 一 特定 类 型 的 对 
象 转换 为 男 一 种 类 型 。 在 Java 中 ， 需 要 在 进行 访问 前 显 式 地 转换 对 象 ; 或 者 转换 后 将 其 存 
储 在 转换 类 型 的 变量 中 。Kotlin 则 简化 了 转换 概念 ， 并 引入 了 智能 转换 这 一 概念 。 

在 Kotlin 中 ， 可 执行 某 些 类 型 转换 操作 ， 其 中 包括 : 

e 显 式 地 将 对 象 转换 为 不 同 的 类 型 (安全 转换 操作 符 )。 

e 将 对 象 转换 为 不 同类 型 ， 或 者 将 可 空 类 型 隐 式 地 转换 为 非 空 类 型 (智能 转换 机 制 )。 


2.5.1 安全 /不 安全 转换 操作 符 
在 强 类 型 语言 中 ， 例 如 Java 或 Kotlin， 需 要 显 式 地 采用 转换 操作 符 ， 并 将 数值 从 一 种 
类 型 转换 为 另 一 种 类 型 。 典 型 的 转换 操作 是 通过 某 种 特定 的 对 象 ， 将 其 转换 为 另 一 种 对 象 


类 型 ， 包 括 超 类 型 〈 向 上 转换 )、 子 类 型 〈 向 下 转换 ) 以 及 接口 。 下 面 考察 Java 中 的 转换 
示例 : 


























Fragment fragment = new ProductFragment (); 
ProductFragment productFragment = (ProductFragment) fragment; 


在 上 述 代码 中 ，ProductFragment 实例 被 赋予 存储 Fragment 数据 类 型 的 变量 。 为 了 将 该 变 
量 赋予 至 仅 可 存储 ProductFragment 数据 类 型 的 productFragment 变量 中 ， 则 需要 执行 显 式 
转换 。 与 Java 不 同 ，Kotlin 设置 了 特定 的 关键 字 as 作为 非 安 全 转换 操作 符 ， 进 而 处 理 转 
换 问题 ， 如 下 所 示 : 


val fragment: Fragment = ProductFragment () 
val productFragment: ProductFragment = fragment as ProductFragment 
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ProductFragment 表示 为 Fragment 的 子 类 型 ， 因 而 上 述 示例 工作 正常 。 这 里 的 问题 是 ， 不 
兼容 类 型 转换 将 会 抛 出 ClassCastException 异常 ， 这 也 是 as 操作 符 称 作 非 安全 转换 操作 符 
的 原因 ， 如 下 所 示 : 


val fragment : String = "ProductFragment" 
val productFragment : ProductFragment = fragment as 
ProductFragment 
// Exception: ClassCastException 
针对 这 一 问题 ， 可 使 用 安全 转换 操作 符 或 as?， 有 时 也 称 作 可 空转 换 操 作 符 。 该 操作 符 尝 
试 将 某 一 值 转换 为 特定 类 型 ， 如 果 该 值 无 法 被 转换 ， 则 返回 null， 如 下 所 示 : 
val fragment: String = "ProductFragment" 
val productFragment: ProductFragment? = fragment as? 
ProductFragment 
注意 , 使 用 安全 转换 操作 符 需要 将 name 变量 定义 为 可 空 类 型 CHI ProductFragment?, ifi4E 
ProductFragment ) 。 作 为 奉 代 方案 ， 可 使 用 非 安全 转换 操作 符 以 及 可 空 类 型 Product 
Fragment?， 因 而 可 实际 查看 到 所 转换 的 类 型 ， 如 下 所 示 : 
val fragment: String = "ProductFragment" 
val productFragment: ProductFragment? - fragment as 
ProductFragment? 
如 果 定 义 非 空 类 型 的 productFragment 变量 ， 则 需要 使 用 elvsi 操作 符 赋予 默认 值 ， 如 
下 所 示 : 
val fragment: String = "ProductFragment" 
val productFragment: ProductFragment? - fragment as? 
ProductFragment ?: ProductFragment () 
当前 , fragment as? ProductFragment 表达 式 将 正确 地 被 计算 。 如 果 该 表达 式 返回 非 空 值 (也 
就 是 说 ， 可 执行 转换 )， 则 对 应 值 将 赋予 productFragment 变量 ， 否则， 默认 值 (Product 
Fragment 的 新 实例 ) 将 被 赋予 至 productFragment 变量 中 。 两 种 操作 符 之 间 的 比较 结果 如 
下 所 示 。 
o 非 安 全 型 转换 Cas): 当 转 换 无 法 实现 时 ， 抛 出 ClassCastException 异常 。 
e 安全 型 转换 (as?): 当 转 换 无 法 实现 时 ， 返 回 null. 
当 理 解 了 非 安 全 型 转换 与 安全 型 转换 之 间 的 差异 后 , 即 可 安全 地 从 fragment 管理 器 中 
获得 fragment， 如 下 所 示 : 


Var productFragment: ProductFragment? = supportFragmentManager 
-findFragmentById(R.id.fragment product) as? ProductFragment 
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安全 型 转换 和 非 安 全 型 转换 操作 符 可 用 于 转换 复杂 对 象 。 当 与 基本 类 型 协同 工作 时 ， 
可 简单 地 使 用 某 种 Kotlin 标准 库 转 换 方 法 。Kotlin 标准 库 的 大 多 数 对 象 中 均 包含 了 相关 方 
法 ， 可 简化 基本 的 类 型 转换 操作 。 转 换 过 程 可 描述 为 : 此 类 函数 设置 了 前 缀 to， 以 及 需要 
转换 的 类 名 。 在 下 列 代码 示例 中 ，Int 类 型 通过 toString 方法 转换 为 String 类 型 。 

Val name: String 


Val age: Int = 12 
name = age.toString(); // Converts Int to String 


下 面 讨论 基本 类 型 及 其 转换 操作 。 
2.5.2 ”智能 转换 


智能 转换 将 某 种 类 型 的 变量 转换 为 另 一 种 类 型 。 与 安全 型 转换 不 同 ， 该 转换 行为 通过 
隐 式 方式 执行 (无 须 使 用 as 或 as? 操 作 符 )。 只 有 当 Kotlin 编译 器 完全 确定 变量 在 检查 后 
不 会 更 改 时 ， 智 能 转换 才 会 起 作用 。 对 于 多 线程 应 用 程序 ， 这 体现 了 一 种 更 为 安全 的 操作 
方式 。 通 常情 况 下 ， 智 能 转换 适用 于 全 部 不 可 变 引 用 以 及 本 地 可 变 引 用 。 智 能 转换 包含 两 
种 类 型 ， 如 下 所 示 。 

e 类 型 智能 转换 :将 某 种 类 型 的 对 象 转换 为 另 一 种 类 型 的 对 象 。 

e 可 空 型 类 型 转换 :将 可 空 型 引用 转换 为 非 空 型 引用 。 

(1) 类 型 智能 转换 

下 面 考察 之 前 提 到 的 Animal 和 Fish 类 ， 如 图 2.6 所 示 。 


















































Animal 








图 2.6 


假设 须 调 用 isHungry 方法 ， 并 检测 animal 是 否 为 Fish 的 实例 。 在 Java 中 ， 可 执行 下 
列 操作 : 
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// Java 

if (animal instanceof Fish)( 
Fish fish = (Fish) animal; 
fish.isHungry(); 
Lh Or 
((Fish) animal) .isHungry(); 


} 
上 述 代码 的 问题 主要 是 元 余 性 .代码 需要 检测 animal 实例 是 否 为 Fish, 随后 显 式 地 将 animal 
转换 为 Fish。 那 么 ， 如 果 编 译 器 能 帮 我 们 处 理 ， 岂 不 是 更 好 ?事实 表明 ， 当 执行 转换 操作 
时 ，Kotlin 编译 器 具有 足够 的 智能 ， 并 通过 智能 转换 机 制 处 理 那 些 元 余 转 换 。 下 列 代 码 则 
是 一 个 智能 转换 示例 : 

if(animal is Fish) ( 

animal.isHungry() 
) 


Android Studio 中 的 智能 转换 


如 果 智 能 转换 失败 ，Android Studio 将 显示 相应 的 错误 消息 , 进而 表明 其 
可 用 性 。 当 访问 一 个 需要 转换 的 成 员 时 , Android Studio 将 对 应 变量 标记 为 绿 


€p 色 背 景 ， 如 图 2.7 所 示 。 
if(animal is Fish)( 


animal.isHungry() 
} 
图 2.7 


在 Kotlin 中 ， 无 须 显 式 地 将 animal 转换 为 Fish， 其 原因 在 于 ， 在 类 型 检测 后 ，Kotlin 
编译 器 可 隐 式 地 处 理 转换 。 当 前 ， 在 站 代码 块 中 ， 变 量 animal 转换 为 Fish。 随 后 ， 最 终结 
果 与 前 述 Java 示例 相同 。 因 此 ， 可 安全 地 调用 isHungry 方法 ， 且 无 须 进行 显 式 转换 。 需 
要 注意 的 是 ， 在 当前 示例 中 ， 智 能 转换 的 范围 仅 限 于 if MGR, W FR: 























if(animal is Fish) ( 
animal.isHungry() // 1 
5 
animal.isHungry() // 2, Error 
在 第 二 行 代码 中 ，animal 示例 表示 为 Fish， 因 而 可 调用 isHungry 方法 。 在 第 4 行 代码 中 ， 
animal 实例 仍 为 Animal， 因 而 无 法 调用 isHungry 方法 。 
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有 些 时 候 ， 智 能 转换 的 操作 范围 将 会 超出 某 个 代码 块 ， 如 下 所 示 : 


val fish:Fish? = // ... 
if (animal !is Fish) // 1 
return 





animal.isHungry() // 1 
在 最 后 一 行 代码 中 ，animal 隐 式 地 转换 为 非 空 型 Fish。 

在 上 述 示例 中 ， 如 果 animal 不 是 Fish， 整 体 方法 将 从 函数 中 返回 。 因 此 ， 编 译 器 在 代 
码 块 的 其 余 范围 内 知晓 animal 定 为 Fish。Kotlin 和 Java 条 件 表达 式 均 可 实现 延迟 计算 。 

这 也 意味 着 ， 在 表达 式 condition10 && condition20 中 ， 仅 当 condition] 返回 true 时 ， 
方法 condition2 才 被 调用 。 这 也 是 条 件 表达 式 右 侧 中 使 用 智能 转换 类 型 的 原因 。 

if (animal is Fish && animal.isHungry()) ( 

println("Fish is hungry") 

) 
注意 ， 若 animal 并 非 是 Fish， 条 件 表达 式 的 第 二 部 分 内 容 将 不 会 被 计算 。 当 计算 完毕 
后 ，Kotlin 即 知晓 animal 即 为 Fish (智能 转换 )。 

(2) 非 空 型 智能 转换 

智能 转换 还 可 处 理 其 他 情形 ， 包 括 空 检测 。 此 处 ， 假 设 view 变量 标记 为 可 空 类 型 一 一 
当前 尚 不 知晓 findViewById 是 否 返回 view 3X null. 

val view: View? = findViewById(R.layout.activity shop) 

安全 操作 符 可 能 用 于 访问 view 中 的 相关 方法 和 属性 。 在 某 些 场合 下 ， 可 能 需要 在 同 
一 对 象 上 执行 更 多 操作 。 此 时 ， 智 能 转换 将 是 一 种 较 好 的 解决 方案 ， 如 下 所 示 : 


val view: View? 






































if ( view != null )( 
view.isShown() 
// view is casted to non-nullable inside if code block 


l 

view.isShown() // error, outside if the block view is nullable 

当 按照 上 述 方式 执行 空 检 测 时 ， 编 译 器 自动 将 可 空 型 view (View?) 转换 为 非 空 型 
(View). AJE, TIYE id 代码 块 中 调用 isShown 方法 ， 且 无 须 使 用 安全 调用 操作 符 。 在 if 
代码 块 之 外 ，view 仍 为 可 空 类 型 。 
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能 转换 仅 与 只 读 类 型 变量 协同 工作 一 一 读 - 写 变量 将 在 执行 检测 和 访问 变量 时 发 生 
除 此 之 外 ， 智 能 转换 还 可 用 于 函数 的 返回 语句 。 如 果 在 包含 返回 语句 的 函数 中 执行 空 
检测 ， 那 么 变量 也 将 转换 为 非 空 类 型 ， 如 下 所 示 : 


fun setView(view: View?)( 
if (view == null) 
return 
// view is casted to non-nullable 
view.isShown() 











Jtr, Kotlin 知晓 当前 变量 值 不 为 null; 否则 将 执行 retum 语句 。 第 3 章 将 对 函数 问题 加 
以 讨论 。 通 过 elvis 操作 符 ， 此 处 可 采用 前 述 更 加 简单 的 语法 ， 并 通过 一 行 代 码 执行 空 检 
测 ， 如 下 所 示 : 
fun verifyView(view: View?) { 
view ?: return 


// view is casted to non-nullable 
view. isShown () 
Vise 

) 


若 不 打算 从 函数 中 返回 ， 并 针对 当前 问题 执行 某 些 显 式 操作 并 抛 出 异常 ， 则 可 结合 elvis 
操作 符 和 错误 消息 机 制 加 以 使 用 ， 如 下 所 示 : 


fun setView(view: View?)( 
view ?: throw RuntimeException ("View is empty") 
// view is casted to non-nullable 
view.isShown() 

) 


综 上 所 述 ， 智 能 转换 是 一 种 功能 强大 的 工具 ， 并 可 有 效 地 减少 空 检测 的 数量 。 因 此 ， 
pw dq oddeWe ecce ia 仅 当 Kotlin 知晓 变量 在 转换 后 〈 甚 至 是 
一 个 线程 ) 无 法 被 更 改 ， 智 能 转换 方 为 有 效 。 


2.6 基本 数据 类 型 

















在 Kotlin H, 一 切 事物 均 表 示 为 对 象 (引用 类 型 ,而 不 是 基本 类 型 )。 也 就 是 说 , Kotlin 
中 不 存在 Java 中 的 基本 类 型 数据 , 这 可 有 效 地 减少 代码 的 复杂 度 ， 从 而 可 在 任意 变量 上 调 
相关 方法 和 属性 。 例 如 ， 下 列 代码 可 将 Int 变量 转换 为 Char: 
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Var code: Int = 75 

code.toChar() 

通常 ， 诸 如 Int. Long 或 Char 均 经 过 适当 优化 (存储 为 基本 类 型 )， 但 仍 可 像 其 他 对 
象 那样 调用 相关 方法 。 
默认 状态 下 ，Java 平台 将 数字 存储 为 JVM 基本 类 型 ， 但 当 需 要 使 用 到 可 空 型 数字 引 
(例如 Int?) 后 调用 泛 型 时 ，Java 将 采用 “ 装 箱 ”(boxed) 表达 形式 .“ 装 箱 ” 机 制 表 明 ， 
基本 元 素 将 被 封装 至 对 应 的 “ 装 箱 ”型 基本 类 型 中 。 这 意味 着 ， 对 应 实例 行为 类 似 于 一 个 
对 象 。 在 Java 中 ， 基 本 类 型 的 “ 装 箱 ” 型 表达 方式 包括 int-Integer、long-Long 等 。 由 于 
Kotlin 代码 将 编译 为 JVM 字 节 码 ， 因 而 对 应 规则 基本 相同 ， 如 下 所 示 : 

var weight: Int = 12 // 1 

var weight: Int? - null // 2 
在 第 一 行 代 码 中 , 数值 存储 为 基本 类 型 ; 在 第 二 行 代码 中 , 数值 存储 为 “ 装 箱 ” 型 整数 CRT 
合 类 型 )。 

因此 ， 当 每 次 生成 某 个 数字 (Byte, Short, Int, Long, Double, Float), Chat 或 Boolean 
时 ， 将 存储 为 基本 类 型 ， 除 非 将 其 声明 为 可 空 类 型 (Byte?、Char?、Array? 等 )， 和 否则 ， 对 
应 数据 将 存储 为 “ 装 箱 ”型 表达 方式 ， 如 下 所 示 : 

var a: Int = 1 // 1 

var b: Int? - null // 2 

b= 12 // 3 
在 第 一 行 代 码 中 ，a 定义 为 非 空 类 型 ， 因 而 存储 为 基本 类 型 ， 在 第 二 行 代码 中 ，b 定义 为 
null， 因 而 存储 为 “ 装 箱 ” 型 表达 方式 ; 在 第 三 行 代码 中 ,，b 仍 存储 为 “ 装 箱 ” 型 表达 方式 ， 
尽管 该 变量 包含 了 一 个 具体 值 。 

泛 型 数据 无 法 通过 基本 类 型 予以 参数 化 ， 因 而 可 采用 “ 装 箱 ” 机 制 。 需 要 注意 的 是 ， 
采用 这 一 类 封装 机 制 ( 而 非 基 本 类 型 ) 可 能 会 对 性 能 产生 影响 , 与 基本 类 型 表达 方式 相 比 ， 
前 者 将 产生 内 存 开销 。 对 于 包含 大 量 数 据 元 素 的 表 和 数组 来 讲 ， 这 种 影响 尤为 明显 。 因此， 
当 对 应 用 程序 性 能 要 求 较 高 时 ， 应 采用 基本 类 型 数据 。 另 外 一 方面 ， 对 于 单 变量 ， 甚 至 是 
多 变量 声明 ， 则 无 须 担 心 数 据 的 表达 类 型 ， 即 使 在 Android 这 一 类 对 内 存 空间 要 求 较 高 的 
设备 上 也 是 如 此 。 

下 面 将 讨论 Kotlin 中 较为 重要 的 基本 数据 类 型 ， 包 括 数字 、 字 符 、 布 尔 值 以 及 数组 。 


2.6.1 数字 
Kotlin 中 的 基本 数字 类 型 等 同 于 Java 中 的 数字 类 型 ， 如 图 2.8 所 示 。 
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Type — Bitwidth 


Double 64 
Float 32 
Long 64 
Int 32 
Short 16 
Byte 8 
图 2.8 


尽管 如 此 ，Kotlin 针对 数字 的 处 理 方式 与 Java 相 比 仍 稍 有 不 同 。 首 先 ， 数 字 间 不 存在 
隐 式 转换 一 一 较 小 的 类 型 不 会 隐 式 地 转换 为 较 大 的 数据 类 型 ， 如 下 所 示 : 


var weight : Int = 12 
var truckWeight: Long = weight // Errorl 


上 述 代 码 说 明 ， 在 缺少 显 式 转换 的 情况 下 ,将 无 法 将 nt 类 型 数值 赋予 Long 变量 。 如 前 所 
述 ， 在 Kotlin 中 ， 一 切 事物 均 为 对 象 ， 因 而 可 调用 相关 方法 ， 并 显 式 地 将 Int 类 型 转换 为 
Long 类 型 ， 进 而 修复 当前 问题 ， 如 下 所 示 : 


var weight:I nt = 12 
var truckWeight: Long - weight.toLong() 


上 述 代 码 类 似 于 模板 代码 ， 但 在 实际 操作 过 程 中 ， 可 有 效 地 避免 与 数字 转换 相关 的 诸多 错 
误 ， 同 时 节省 大 量 的 调试 时 间 。 相 应 地 ，Kotlin 标准 库 针 对 数字 支持 下 列 转换 方法 : 


toByte(): Byte. 
toShort(): Short. 
toInt(): Int. 
toLong(): Long. 
toFloat(): Float. 
toDouble(): Double. 
toChar(): Char. 


然而 ， 仍 可 显 式 地 确定 数字 字面 值 ， 并 调整 为 推断 变量 类 型 ， 如 下 所 示 : 


val ar Int = q 
val b =a + 1 // Inferred type is Int 
val b = a + 1L // Inferred type is Long 


在 数字 方面 ，Kotlin 和 Java 之 间 的 第 二 个 差别 是 : 在 某 些 时 候 ， 数 字 的 字面 值 稍 有 不 
同 。 对 于 整数 值 ， 存 在 下 列 多 种 字面 常量 : 
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27 // Decimals by default 

27L // Longs are tagged by a upper case L suffix 
0x1B // Hexadecimals are tagged by 0x prefix 
0b11011 // Binaries are tagged by 0b prefix 


Kotlin 并 不 支持 八进制 字面 值 ， 但 会 支持 浮 点 数 的 常规 表示 法 ， 如 下 所 示 : 


27.5 // Inferred type is Double 
27.5F // Inferred type is Float. Float are tagged by f or F 

















2.6.2 ”字符 

Kotlin 的 字符 存储 为 Char 类 型 。 在 大 多 数 时 候 ， 字 符 与 字 因此 本 节 主 要 
考察 二 者 间 的 相似 性 和 差异 。 当 定义 Char 时 ， 须 使 用 单 引 号 ， 这 一 点 与 字符 串 的 双 引 号 
有 所 不 同 ， 如 下 所 示 : 

val char = 'a' // 1 


val string - "a" // 2 


在 第 一 行 代码 中 ， 定 义 了 类 型 为 Char 的 变量 ， 第 二 行 代码 则 定义 了 String 类 型 的 变量 。 
在 字符 和 字符 串 中 ， 可 通过 反 斜 杠 表示 转 义 字符 ， 如 下 所 示 : 


\t: 制 表 符 。 

\b: 退 格 键 。 

\n: 换行 符 。 

Wei 换行 符 。 

: 单 引号 。 

Ws 双 引 号 。 

\\: RAGES. 

\$: 美元 字符 。 

Vu: Unicode 转 义 序列 。 


下 列 代码 定义 了 包含 yinYang Unicode (U+262F) 的 Char 类 型 


var yinYang = '\u262F' 


eooeoeeveveee 
E 


2.6.3 数组 


在 Kotlin 中 ， 数 组 表示 为 Array 类 。 当 在 Kotlin 中 创建 一 个 数组 时 ， 需 要 使 用 多 个 
Kotlin 标准 库 函 数 。 其 中 ，arrayOf0 则 是 最 为 简单 的 函数 ， 如 下 所 示 : 


val array = arrayOf(1,2,3) // inferred type Array<Int> 
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默认 状态 下 ， 该 函数 将 创建 Int 数组 。 相 应 地 ， 若 打算 定义 Short EX Long 数组 ， 则 可 显 式 
地 定义 数组 类 型 ， 如 下 所 示 : 

val array2: Array<Short> = arrayOf (1,2,3) 

val array3: Array<Long> = arrayOf (1,2,3) 

如 前 所 述 ， 采 用 “ 装 箱 ” 式 表达 形式 将 降低 应 用 程序 的 性 能 。 因 此 ，Kotlin 提供 了 某 
些 特定 类 , 以 表示 基本 类 型 的 数组 , 进而 减少 内 存 开 销 , 即 ShortArray、 IntArray、 LongArray 
等 。 尽 管 定义 了 系统 的 方法 集 和 属性 集合 ， 但 这 些 类 与 Array 类 并 不 包含 继承 关系 。 当 创 
建 类 实例 时 ， 须 使 用 相应 的 工厂 函数 ， 如 下 所 示 : 

val array = shortArrayOf(1, 2, 3) 


val array = intArrayOf(1, 2, 3) 
val array = longArrayOf (1, 2, 3) 


需要 注意 其 中 的 某 些 差异 一 一 此 类 方法 外 观 相似 , 但 却 生成 不 同类 型 的 表达 方式 , 如 下 所 示 : 

val array = arrayOf(1,2,3) // 1 

val array = longArrayOf (1, 2, 3) // 2 
第 一 行 代码 表示 Long 数据 元 素 的 泛 型 数组 (推断 类 型 ，Array<Long>)。 第 二 行 代码 则 表 
示 包 含 基本 Long 数据 元 素 的 数组 (推断 类 型 LongArray)。 

知晓 数组 的 实际 尺寸 往往 会 提升 性 能 , EE, Kotlin 定义 了 另 一 个 库 函 数 arrayOfNulls， 
并 生成 一 个 包含 null 元 素 的 既定 尺寸 数组 ， 如 下 所 示 : 

val array = arrayOfNulls(3) // Prints: [null, null, null] 

println(array) // Prints: [null, null, null] 

除 此 之 外 ， 还 可 使 用 工厂 函数 填充 预定 义 尺 寸 的 数组 ， 并 使 用 数组 尺寸 作为 第 一 个 参 
数 ， 并 且 lambda 可 以 返回 每 个 数组 元 素 的 初始 值 作为 第 二 个 参数 ， 如 下 所 示 : 

val array = Array (5) { it * 2 } 

println(array) // Prints: [0, 2, 4, 8, 10] 

第 5 章 将 详细 讨论 lambda (匿名 函数 )。 另 外 ，Kotlin 中 数组 的 访问 方式 与 Java 相同 ， 
如 下 所 示 : 

val array = arrayof (1,2,3) 

println(array[1]) //Prints: 2 

同时 ， 数 据 元 素 的 索引 方式 也 与 Java 相同 ， 也 就 是 说 ， 第 一 个 元 素 的 索引 为 0， 第 二 
个 元 素 的 索引 为 1， 等 等 。 在 Kotlin 中 ， 数 组 是 保持 不 变 的 ， 这 一 点 与 Java 不 同 。 相 关内 
容 将 在 第 6 章 加 以 讨论 。 
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2.6.4 布尔 类 型 


布尔 类 型 表示 为 一 种 逻辑 类 型 ， 并 包含 两 种 可 能 值 ， 即 true 和 false。 除 此 之 外 ， 还 可 
使 用 可 空 的 布尔 类 型 ， 如 下 所 示 : 


val isGrowing: Boolean = true 
val isGrowing: Boolean? - null 


另外 ， 布 尔 类 型 还 支持 大 多 数 编程 语言 中 的 标准 内 建 操作 ， 如 下 所 示 : 


e |i: 表示 为 逻辑 OR 操作 。 当 两 个 判断 式 中 的 任意 一 个 为 true 时 则 返回 true. 
e ca: 逻辑 AND 操作 。 当 两 个 判断 式 均 为 true 时 则 返回 true. 
e ! : 否定 运算 符 。 针 对 false 返回 true; 而 对 true， 则 返回 false. 


注意 ， 针 对 任意 条 件 类 型 ， 仅 可 使 用 非 空 布尔 值 。 
类 似 于 Java， 仅 在 必要 时 | 和 && 方 采用 延迟 计算 。 


2.7 复合 数据 类 型 




















本 节 考 察 Kotlin 中 相对 复杂 的 数据 类 型 。 与 Java 相 比 , 某 些 数据 类 型 得 到 了 较为 明显 
的 改善 ， 同 时 还 包含 了 一 些 全 新 的 数据 类 型 。 


2.71 FHE 


Kotlin 字符 串 的 行为 方式 与 Java 类 似 ， 但 存在 几 点 改进 措施 。 当 在 特定 索引 处 访问 字 
符 时 ， 可 使 用 索引 操作 符 ， 并 采用 与 访问 数组 元 素 相同 的 方式 访问 字符 串 ， 如 下 所 示 ; 


val str = "abcd" 
println (str[1]) // Prints: b 


另外 ， 还 可 访问 Kotlin 标准 库 中 的 各 种 扩展 ， 进 而 可 方便 地 与 字符 串 协同 工作 ， 如 下 
所 示 : 

val str = Melejets ty 

println(str.reversed()) // Prints: dcba 

printin(str.takeLast(2)) // Prints: cd 


println("john8test.com".substringBefore("8")) // Prints: john 
printin("john@test.com".startsWith("@")) // Prints: false 


这 与 Java 中 的 String 类 保持 一 致 ， 因 而 相关 方法 并 不 隶属 于 String 类 ， 而 是 定义 为 扩展 。 
第 7 章 将 对 此 进行 详细 介绍 。 
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@ 读者 可 参考 String 类 文档 ， 以 考察 相关 方法 的 完整 列表 ( 对 应 网 址 为 
https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/ ). 





字符 串 的 构建 过 程 并 不 复杂 , 在 Java 中 ,通常 需要 使 用 到 较 长 的 连接 表达 式 。 在 下 列 
Java 示例 中 ， 字 符 串 由 多 个 元 素 构建 而 成 。 

//Java 

String name - "Eva"; 

int age - 27; 

String message = "My name is" + name + "and I am" + age + "years old"; 

在 Kotlin 中 ， 通 过 字符 串 模板 ， 可 极 大 地 简化 字符 串 的 创建 过 程 。 对 此 ， 可 不 采用 连 
接 方式 ， 并 可 通过 美元 符号 〈 构 造 占 位 符 ) 简单 地 将 某 个 变量 置 于 字符 串 中 。 在 数据 插入 
过 程 中 ， 字 符 串 占 位 符 将 被 实际 值 蔡 换 ， 如 下 所 示 : 

val name = "Eva" 

val age - 27 

val message = "My name is $name and I am $age years old" 

println (message) 

// Prints: My name is Eva and I am 27 years old 
这 可 视 作 一 种 高 效 的 连接 方式 , 编译 器 代码 生成 一 个 StringBuilder， 并 附加 所 有 部 分 内 容 。 
同时 ， 字 符 串 模 板 并 不 仅 限于 单 变量 ， 还 可 涵盖 “&{” 和 “}” 字 符 之 间 的 整体 表达 式 。 
除 此 之 外 ， 还 可 表示 为 一 个 函数 调用 ， 并 返回 数值 或 属性 访问 ， 如 下 所 示 : 

val name = "Eva" 


val message = "My name has ${name.length} characters" 
printin(message) // Prints: My name has 3 characters 


上 述 语法 可 创建 更 为 简洁 的 代码 ， 当 变量 或 表达 式 中 的 某 个 值 构造 字符 串 时 ， 无 须 打 断 该 
字符 串 。 


2.72 范围 





















































范围 是 数值 序列 的 一 种 定义 方式 ， 并 通过 序列 中 的 首 、 尾 值 表 示 。 利 用 范围 ， 可 存储 
重量 、 温 度 、 时 间 以 及 年 龄 等 数据 。 范 围 可 利用 两 个 “.” 了 予以 表示 〈 实 际 上 是 rangeTo 操 
作 符 )， 如 下 所 示 : 

val intRange = 1..4 // 1 

val charRange- 'b'..'g' //2 
在 第 一 行 代码 中 ， 推 断 类 型 为 ntRange C NUES i>= 1 &&i<=4)。 在 第 二 行 代码 中 ， 
推断 类 型 为 CharRange (字母 对 应 形式 为 从 b' 至 'g')。 
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qp 需要 注意 的 是 ， 应 使 用 单 引号 定义 字符 范围 。 

















Int, Long 和 Char 范围 可 用 于 在 for..each 循环 中 遍历 下 一 个 数值 ， 如 下 所 示 : 


for (i in 2:25) print(i) // Prints: 1234 
for (i in 'b'..'g') print(i) // Prints: bcdefg 


范围 还 可 用 于 检测 某 一 值 大 于 初始 值 或 小 于 终止 值 ， 如 下 所 示 : 


val weight = 52 
val healthy - 50..75 























if (weight in healthy) 
println("$weight is in $healthy range") 
// Prints: 52 is in 50..75 range 














同时 还 可 针对 其 他 范围 类 型 采用 这 一 方式 ， 例 如 CharRange。 如 下 所 示 : 


val c = 'k' // Inferred type is Char 
val alphabet = 'a'..'z' 


if(c in alphabet) 
println("$c is character") //Prints: k is a character 


在 Kotlin 中 ， 范 围 处 于 闭合 状态 〈 包 括 端 值 )， 这 意味 着 ， 范 围 端 值 纳入 至 当前 范围 
如 下 所 示 : 
for ti in. 1-1) prank) // Prints: 123 

注意 ， 默 认 状态 下 ，Kotlin 中 的 范围 呈 递 增 状态 〈 默 认 步 进 值 为 1)， 如 下 所 示 : 
for (i in 5..1) print(i) // Prints nothing 

当 采 用 逆向 遍历 时 ， 须 使 用 downTo 函数 将 步 进 值 设置 为 -1， 如 下 所 示 : 


for (i in 5 downTo 1) print(i) // Prints: 54321 














除 此 之 外 ， 还 可 设置 不 同 的 步 进 值 ， 如 下 所 示 : 


for (i in 3..6 step 2) print(i) // Prints: 35 














注意 ， 在 3..6 范围 内 ， 并 不 输出 最 后 一 个 数值 元 素 ， 其 原因 在 于 : RE SI CER UA 
历时 移动 两 个 步 长 。 因 此 ， 首 次 遍历 后 对 应 值 为 3， 第 二 次 遍历 后 值 为 5， 最后， 第 三 次 
遍历 后 值 为 7 一 一 由 于 超出 了 当前 范围 ， 因 而 该 值 将 被 忽略 。 









































第 2 章 Kotlin 语言 基础 知识 


。45 。 


step 定义 的 步 长 须 为 正 值 。 如 果 设 置 了 一 个 负 值 步 长 ， 则 应 将 downTo 函数 与 step ER 














数 协同 使 





， 如 下 所 示 : 





for (i in 9 downTo 1 step 3) print(i) // Prints: 963 


273 集合 





与 集合 协同 工作 可 视 为 程序 设计 中 的 重要 内 容 ， 相 比 于 Java，Kotlin 提供 了 多 种 类 型 


的 集合 以 及 改进 措施 。 第 7 章 将 对 此 进行 深入 讨论 。 
2.8 语句 和 表达 式 


与 Java 相 比 ，Kotlin 提供 了 更 为 广泛 的 表达 式 应 用 空间 ,读者 有 必要 了 解 语句 和 表达 





式 之 间 的 差别 。 程 序 基本 上 可 表示 为 一 个 语句 和 表达 式 序 列 。3# 


其 中 ， 表 达 式 生成 某 个 值 ， 





并 可 作为 另 一 个 表达 式 、 变 量 赋值 或 函数 参数 中 的 部 分 内 容 。 另 外 ， 表 达 式 可 表示 为 一 个 
或 多 个 操作 数 《 供 操作 的 数据 ) 以 及 一 个 或 多 个 操作 符 形成 的 操作 符 (表示 特定 操作 的 符 


号 )， 并 可 计算 为 某 个 单一 值 ， 如 图 2.9 所 示 。 


表达 式 值 赋 
与 该 变量 中 操作 数 





var speed = currentSpeed + getAcceleration() 


| 

















表达 式 
图 2.9 
表 2.3 显示 了 Kotlin 中 的 一 些 表 达 式 示例 。 
表 2.3 
表达 式 〈 生 成 某 个 值 ) 表达 式 类 型 
a- true Boolean 
a — "foo" + "bar" String 
a= min(2, 3) Integer 
a = computePosition().getX() getX 的 返 Integer 
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另外 一 方面 ， 语 句 执行 某 项 操作 ， 且 无 法 赋值 于 某 个 变量 中 。 其 中 ， 











语句 可 包含 用 


F 定 义 类 〈class)、 接 口 (interface)、 变 量 (val, var), PAR (fun)、 循 环 罗 辑 (break 

















和 continue) 等 语言 关键 字 。 另 外 ， 当 忽略 表达 式 的 返回 值 时 ， 表 达 式 也 可 视 作 语句 〈 不 
可 将 值 赋予 变量 ， 不 可 从 函数 中 返回 ， 不 可 将 其 用 作 其 他 表达 式 中 的 部 分 内 容 ， 等 等 )。 
Kotlin 是 一 种 面向 表达 式 的 语言 。 也 就 是 说 ，Java 语言 中 的 大 多 数 结构 可 视 作 Kotlin 
中 的 表达 式 。 实 际 上 ，Java 和 Kotlin 针对 控制 结构 具有 不 同 的 看 待 方式 。 在 Java 中 ,控制 





结构 表示 为 语句 ， 而 Kotlin 则 将 其 视 为 表达 式 〈 除 了 循环 结构 之 外 )。 这 也 表明 ，Kotlin 


可 通过 控制 结构 编写 简洁 的 代码 。 稍 后 将 考察 具体 示例 。 


29 控制 流 


Kotlin 包含 了 大 量 源 自 Java 中 的 控制 流 , 但 提供 了 更 加 灵活 、 简便 的 操作 方式 。 例如， 


Kotlin 中 提供 了 when 控制 流 结构 ， 并 以 此 蔡 换 Java 中 的 switch…case。 
2.9.1 于 语句 
Kotlin 中 的 让 语句 与 Java 具有 同等 作用 ， 如 下 所 示 : 


val x = 3 


if(x > 10){ 

println ("greater") 
) else ( 

println ("smaller") 
t 


在 Kotlin 中 ， 站 代码 块 可 包含 一 条 语句 或 表达 式 ， 如 下 所 示 : 
Wa c 
if(x » 10) 

println ("greater") 


else 
printin ("smaller") 


在 Java 中 , 被 视 作为 一 条 语句 ， 而 Kotlin 则 将 其 定义 为 一 个 表达 式 。 

















这 也 是 两 种 语 


言 之 间 的 主要 差异 之 一 ; 当然 ，Kotlin 使 用 了 更 为 简洁 的 语法 。 例 如 ， 可 将 让 表达 式 的 结 





果 直 接 传 递 至 函数 参数 ， 如 下 所 示 : 


rintln(if(x > 10) "greater" else "smaller") 
P. g 
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时 
另 











于 过 表达 式 计算 后 传递 至 println 方法 中 ,因而 代码 被 压缩 为 一 行 。 当 条 件 x> 10 为 tue 
， 表 达 式 返回 第 一 个 分 支 (greater)， 否 则 表达 式 返 回 第 二 个 分 支 (smaller)。 下 面 考 察 
一 个 示例 ， 如 下 所 示 : 


val hour = 10 
val greeting: String 
if hour < 18) f 
greeting - "Good day" 
) else ( 
greeting - "Good evening" 











) 


其 中 自用 作 一 条 语句 。 如 前 所 述 ，Kotlin 中 的 站 表示 为 一 个 表达 式 ， 该 表达 式 的 结果 可 
赋予 某 个 变量 中 。 通 过 这 一 方式 , 可 将 让 表达 式 结果 直接 赋予 变量 greeting H, 如 下 所 示 : 








val greeting = if (hour < 18) "Good day" else "Good evening" 


但 某 些 时 候 ， 站 语句 分 支 中 还 须 放置 其 他 一 些 代码 。 对 此 ， 仍 可 将 寺 用 作 表 达 式 。 随 
> ME 让 分 支 的 最 后 一 行 代码 将 作为 结果 予以 返回 ， 如 下 所 示 ; 
val hour = 10 
val greeting - if (hour « 18) ( 
//some code 
"Good day" 
} else ( 
//some code 
"Good evening" 
H 





println(greeting) // Prints: "Good day" 


如 果 使 用 站 作为 表达 式 而 非 语 句 ， 该 表达 式 需 要 包含 else 分 支 。 相 比 之 下 ，Kotlin 版 





本 更 优 于 Java. HF greeting 变量 定义 为 非 空 类 型 ， 编 译 器 将 验证 让 的 整体 表达 式 ， 检 测 
过 程 涉 及 包含 分 支 条 件 的 全 部 情况 。 考 虑 到 让 可 视 作 表达 式 ， 因 而 可 将 其 用 在 字符 串 模板 


























中 ， 如 下 所 示 : 


val age = 18 
val message = "You are $( if (age < 18) "young" else "of age" } person" 
printin(message) // Prints: You are of age person 


与 Java 相 比 ， 将 让 视 为 表达 式 可 获得 更 大 的 灵活 性 。 
2.9. when 表达 式 
Kotlin 中 的 when 表达 式 是 一 种 多 路 分 支 语句 。when 表达 式 旨 在 替代 Java 中 的 





“48 。 零 基 础 学 Kotlin 编程 





switch...case 语句 。 与 一 系列 的 i£. else..if FALE, when 可 视 为 一 种 更 好 的 替代 方案 ， 同 时 
可 提供 更 加 简洁 的 语法 ， 例 如 : 


when (x) ( 

1 -» print("x — 1") 

2 -» print("x == 2") 

else -> println("x is neither 1 nor 2") 
) 





其 中 ，when 表达 式 逐 一 与 全 部 分 支 进行 参数 匹配 ， 直 至 满足 某 个 分 支 条 件 。 该 行为 类 似 
于 switch...case， 但 无 须 在 每 个 分 支 后 重复 书写 多 个 break 语句 。 

FMW if FA), when 的 使 用 方式 包括 忽略 返回 值 的 语句 ， 以 及 赋值 于 变量 中 的 表达 
式 。 若 when 用 作 表 达 式 ， 满 足 分 支 最 后 一 行 的 对 应 值 将 成 为 整体 表达 式 值 ; 若 用 作 语句 ， 
对 应 值 则 简单 地 予以 忽略 。 通常, 如 果 不 存在 任何 分 支 可 满足 当前 条 件 , 则 计算 else 分 支 ， 
如 下 所 示 : 


val vehicle = "Bike" 
































val message- when (vehicle) ( 
"carm => f 
// Some code 
"Four wheels" 
) 
"Bike" -> ( 
// Some code 
"Two wheels" 
} 
else ca fj 
//some code 
"Unknown number of wheels" 


} 


Println (message) //Prints: Two wheels 


若 分 支 中 包含 了 多 条 指令 , 须 将 其 置 于 由 {...} 定 义 的 代码 块 中 。 当 when 用 作 表 达 式 时 (when 
的 计算 值 赋予 变量 中 )， 各 代码 块 的 最 后 一 行 语句 视 作 返回 值 。 这 一 行为 与 让 表达 式 相 同 。 
不 难 发 现 ， 这 也 是 Kotlin 结构 中 的 常见 行为 ， 本 书后 续 内 容 还 将 对 此 加 以 深入 讨论 。 

若 when HERIZ, M else 须 强制 存在 ， 除 非 编译 器 可 证 实 分 支 条 件 覆 盖 全 部 情况 。 
另外 ， 当 使 用 逗号 时 ， 还 可 在 一 个 分 支 中 处 理 多 个 匹配 参数 ， 如 下 所 示 : 
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val vehicle - "Car" 
when (vehicle) ( 

"Car", "Bike" -> print ("Vehicle") 

else -» print("Unidentified funny object") 
} 


when 另 一 个 较 好 的 特性 是 可 检测 变量 类 型 。Kotlin 可 方便 地 验证 特定 类 型 的 is 或 !is 
值 。 此 处 ， 智 能 转换 将 再 次 派 上 用 场 一 一 无 须 额外 检测 ， 即 可 在 某 个 分 支 代码 块 中 访问 匹 
配 类 型 的 方法 和 属性 ， 如 下 所 示 : 


val name = when (person) ( 
is String -> person.toUpperCase() 
is User -» person.name 
// Code is smart casted to String, so we can 
// call String class methods 
VUE 























) 


类 似 地 ，when 还 可 检测 包含 特定 值 的 对 应 范围 和 集合 。 下 面 使 用 is 和 !is 关键 字 ， 如 
下 所 示 


val riskAssessment = 47 


val risk - when (riskAssessment) ( 
in 1..20 -> "negligible risk" 
fin 21..40 -> "minor risk" 
!in 41..60 -> "major risk" 
else -» "undefined risk" 

) 


printin(risk) // Prints: major risk 
实际 上 ，when 分 支 的 右 侧 可 放置 任意 类 型 的 表达 式 ， 可 以 是 方法 调用 或 其 他 表达 式 。 
考察 下 列 代码 示例 ， 其 中 ， 第 二 个 when 表达 式 用 于 else 语句 。 


val riskAssessment = 80 
val handleStrategy - "Warn" 




















val risk = when (riskAssessment) { 
in 1..20 -» print("negligible risk") 
lin 21..40 -> print("minor risk") 
lin 41..60 -> print ("major risk") 
else -> when (handleStrategy) { 
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"Warn" -> "Risk assessment warning" 
"Ignore" -» "Risk ignored" 
else -» "Unknown risk!" 


} 


println(risk) // Prints: Risk assessment warning 


如 前 所 述 ，when 是 一 种 功能 强大 的 结构 ， 与 Java 的 switch 结构 相 比 具有 更 多 的 控制 
行为 ， 且 不 仅 限于 检测 等 式 。 除 此 之 外 ，when 甚至 还 可 替代 于 ..else if HAGE. WR when 
表达 式 中 未 包含 任何 参数 ， 分 支 条 件 将 类 似 于 布尔 表达 式 ， 并 在 对 应 条 件 为 tue 时 执行 该 
分 支 ， 如 下 所 示 : 

private fun getPasswordErrorId(password: String) = when ( 

password.isEmpty() -» R.string.error field required 
passwordInvalid(password) -» R.string.error invalid password 
else -» null 

) 

上 述 全 部 示例 均 需 要 使 用 到 else 分 支 。 当 涉及 全 部 可 能 情况 时 , 可 忽略 某 个 else 分 支 。 
下 面 考察 基于 布尔 类 型 的 简单 示例 : 

val large:Boolean = true 

when (large) { 

true -» println ("Big") 
false -» println("Big") 


























) 
编译 器 可 验证 全 部 可 能 值 将 被 处 理 ， 因 而 无 须 确定 else 分 支 。 相 同 的 逻辑 也 可 应 用 于 枚 举 
结构 和 封装 类 中 ， 第 4 章 将 对 此 加 以 讨论 。 

Kotlin 编译 器 负责 执行 检测 ， 因 而 可 确保 各 种 情况 均 不 会 被 遗漏 。 这 也 降低 了 Java 中 
各 种 bug 出 现 的 概率 。 其 中 ， 开 发 人 员 往 往 会 忘记 处 理 switch 语句 中 的 某 些 问题 〈 尽 管 多 
态 通常 是 一 类 较 好 的 解决 方案 )。 

2.9.3 循环 

作为 一 种 控制 结构 ， 循 环 重复 执行 统一 指令 集 ， 直 至 满足 结束 条 件 。 在 Kotlin 中 ， 循 
环 操 作 可 通过 迭代 器 进行 遍历 。 这 里 ， 和 迭代 器 定义 为 一 种 接口 ， 并 包含 了 两 个 方法 ， 即 
hasNext 和 next 方法 ， 并 可 遍历 集合 、 范 围 、 字 符 串 ， 以 及 其 他 可 表示 为 元 素 序列 的 实体 。 

当 执 行 循环 访问 操作 时 ， 须 提供 iterator() 方 法 。 由 于 字符 串 并 未 定义 该 
FE, AmE Kotin 中 表示 为 扩展 函数 。 关 于 扩展 ， 第 7 章 将 对 此 加 以 讨论 。 

















式 均 


Java 
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Kotlin 提供 了 3 种 循环 类 型 ， 即 for. while 和 do…while， 且 与 其 他 编程 语言 的 工作 方 


为 相同 ， 因 而 下 面 对 其 进行 简要 介绍 。 
1. for 循环 








Java 中 经 典 的 for 循环 ( 须 显 式 定义 迭代 器 ) 并 未 出 现 于 Kotlin 中 ， 下 列 示例 展示 了 





中 的 此 类 循环 方式 。 
//Java 
String str = "Foo Bar"; 


for(int i-0; i«str.length(); i++) 
System.out.println(str.charAt (i)) 


当 在 开始 和 结束 之 间 对 集合 各 项 进行 


所 示 : 


其 中 
外 ， 
5| f 





var array = arrayOf(1, 2, 3) 


for (item in array) ( 
print (item) 
) 








; 





循环 遍历 时 ， 可 简单 地 使 用 for 循环 ， 如 下 





另外 ， 无 须 使 用 循环 体 也 可 对 其 进行 定义 ， 如 下 所 示 : 


for (item in array) 
print (item) 





若菜 个 集合 定义 为 泛 型 集合 ， 那 么 ， 其 中 的 数据 项 将 智能 转换 为 与 泛 型 集合 类 型 对 应 
的 数据 类 型 。 换 而 言 之 ， 如 果 某 个 集合 包含 类 型 为 Int 的 数据 元 素 ， 则 数据 项 会 智能 转换 
为 Int 类 型 ， 如 下 所 示 : 


var array = arrayOf(1, 2, 3) 


for (item in array) 
print(item) // item is Int 


除 此 之 外 ， 还 可 通过 索引 循环 遍历 集合 ， 如 下 所 示 : 


for (i in array.indices) 
print (array[i]) 





参数 array.indices 返回 包含 全 部 索引 的 IntRange， 这 等 价 于 (1.. array. 

















还 存在 另 一 个 withIndex 库 方法 ， 可 返 





[E] IndexedValue 属性 列表 ， 其 9 


length - 1). 5 








一 个 数值 ， 并 可 通过 下 列 方 式 析 构 数据 元 素 : 


FP 包含 了 一 个 索 
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for ((index, value) in array.withIndex()) ( 
println("Element at $index is $value") 
l 


此 处 ，(index, value) 结构 称 作 析 构 声明 ， 第 4 章 将 对 此 加 以 讨论 。 
2. while 循环 
当 对 应 的 条 件 表达 式 为 tue 时 ，while 循环 重复 执行 某 个 代码 块 ， 如 下 所 示 : 


while (condition) { 
// code 
} 
另外 ， 如 果 条 件 表达 式 返 回 tue，do…while 循环 同样 重复 执行 代码 块 ， 如 下 所 示 : 
do ( 
// code 
) while (condition) 
与 Java 不 同 ，Kotlin 可 使 用 声明 于 do…while 循环 中 的 变量 ， 并 将 其 用 作 条 件 ， 如 下 
所 示 : 
do ( 
var found - false 
Mls es 
} while (found) 
while 和 do---while 循环 之 间 的 主要 差别 在 于 ， 何 时 计算 条 件 表 达 式 。 其 中 ，while f 
环 在 代码 执行 前 检测 相关 条 件 : 如 果 该 条 件 不 为 tue， 则 不 执行 代码 。 另 外 一 方面 ，do… 
while 循环 则 首先 执行 循环 体 ， 随 后 计算 条 件 表达 式 。 因 而 ， 循 环 体 至 少 执行 一 次 。 如 果 
对 应 条 件 为 tue， 则 循环 重复 执行 ， 否 则 循环 结束 。 


3. 其 他 循环 结构 


通过 内 建 的 库 函数 ， 还 存在 其 他 一 些 集合 遍历 方式 ， 例 如 forEach。 第 7 章 将 对 此 加 
以 讨论 。 














2.9.4 break 和 continue 


Kotlin 中 的 全 部 循环 结构 均 支 持 经 典 的 break 和 continue if). continue 语句 将 继续 执 
行 循环 的 下 一 次 迭代 ， 而 break 则 终止 执行 最 内 部 的 闭合 循环 ， 如 下 所 示 : 
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val range - 1..6 


for(i in range) { 
print(^$3 ") 
l 


Yf prints: 123450 
下 面 加 入 相关 条 件 ， 并 在 该 条 件 满足 时 退出 循环 ， 如 下 所 示 : 


val range = 1..6 


for(i in range) { 
print("$i ") 


if (i == 3) 
break 
H 


Z printsi 1 2.3 

当 处 理 内 嵌 循 环 时 ，break 和 continue 语句 十 分 有 用 ， 并 可 简化 控制 流 ， 显 著 降 低 所 
执行 的 工作 量 ， 进 而 节省 宝贵 的 Android 资源 。 下 面 考察 内 媒 循 环 ， 并 尝试 退出 外 部 循环 ， 
如 下 所 示 : 

val intRange = 1..6 

val charRange = 'A'..'B' 


for(value in intRange) ( 
if(value -- 3) 
break 


println("Outer loop: $value ") 


for (char in charRange) ( 
println("NtInner loop: $char ") 
} 
} 


// prints 

Outer loop: 1 
Inner loop: A 
Inner loop: B 

Outer loop: 2 
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Inner loop: A 
Inner loop: B 


其 中 ， 在 第 三 次 迭代 时 ， 使 用 break 语句 终止 了 外 部 循环 ， 因 而 内 嵌 循 环 也 随 之 结束 。 注 
Eo x 转 义 序列 可 在 控制 台中 实现 缩 进 格式 。 另 外 ， 还 可 使 用 continue 语句 略 过 循环 中 的 
当前 迭代 ， 如 下 所 示 : 


val intRange = 1..5 











for(value in intRange) { 
if(value -- 3) 
continue 


println("Outer loop: $value ") 


for (char in charRange) ( 
println("NtInner loop: $char ") 
} 
H 


// prints 

Outer loop: 1 
Inner loop: 
Inner loop: B 

Outer loop: 2 
Inner loop: 
Inner loop: B 

Outer loop: 4 
Inner loop: A 
Inner loop: B 

Outer loop: 5 
Inner loop: A 
Inner loop: B 


其 中 ， 若 当前 值 等 于 2， 则 略 过 外 部 循环 中 的 当前 迭代 。 

continue 和 break 语句 均 在 闭合 循环 中 执行 相关 操作 。 然 而 ， 某 些 时 候 ， 可 能 需要 从 
内 部 另 一 个 循环 中 终止 或 略 过 循环 的 迭代 。 例 如 ， 从 内 部 循环 中 终止 外 部 循环 欠 代 ， 如 下 
所 示 : 

for (value in intRange) ( 


for (char in charRange) ( 
// How can we break outer loop here? 


» 


» 





} 
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然而 ，continue 和 break 语句 包含 了 两 种 形式 ， 即 标记 〈 注 解 ) 形式 和 非 标记 形式 。 
前 述 内 容 曾 对 非 标记 形式 有 所 讨论 ， 下 面 采 用 标记 形式 处 理 当前 问题 。 下 列 示例 展示 了 标 
记 break 语句 的 使 用 方式 。 

val charRange = 'A'..'B* 

val intRange = 1..6 





outer? for(value in intRange) ( 
println("Outer loop: $value ") 


for (char in charRange) ( 
if (char == 'B') 
break@outer 
println("NtInner loop: $char ") 
} 
// prints 


Outer loop: 1 
Inner loop: A 





其 中 ，@outer 表示 为 标记 名 。 根 据 惯例 ， 标 记名 以 @ 开 始 ， 随 后 是 标记 名 。 另 外 ， 标 记 置 
于 循环 之 前 。 对 循环 进行 标记 支持 使 用 合法 的 break (break@outer)， 这 也 是 一 种 终止 循环 
执行 〈 由 该 标记 所 引用 ) 的 方法 。 之 前 的 有 效 break (包含 标记 的 break) 将 跳跃 至 〈 采 用 
该 标记 标识 的 ) 循环 之 后 的 执行 点 处 。 

设置 retum 语句 将 退出 全 部 循环 ， 并 从 匿名 或 命名 函数 中 返回 ， 如 下 所 示 : 


fun doSth() ( 
val charRange - 'A'..'B' 
val intRange - 1..6 


for(value in intRange) ( 
printin("Outer loop: $value ") 


for (char in charRange) ( 
printin("\tInner loop: $char ") 
return 
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// usage 

println("Before method call") 
doSth () 

printin("After method call") 


// prints 
Outer loop: 1 
Inner loop: A 


调用 该 方法 后 ， 将 显示 下 列 输出 结果 : 


Outer loop: 1 
Inner loop: A 




















a 


210 3t 


大 多 数 Java 程序 设计 书籍 中 均 提 出 了 验证 检查 这 一 概念 ， 例 如 Effective Java 一 书 。 
这 也 表明 , 通常 需要 对 参数 或 对 象 的 状态 进行 验证 , 如 果 验 证 检测 无 效 , 则 抛 出 异常 。Java 
异常 机 制 包 含 两 种 类 型 的 异常 ， 即 检查 型 异常 和 非 检 查 型 异常 。 

非 检 查 型 异常 表示 ， 开 发 人 员 不 必 强 制 使 用 try…catch 代码 块 捕捉 异常 。 默 认 状 
态 下 ， 异 常会 上 行 至 调用 栈 ， 因 而 可 确定 是 否 对 其 进行 捕捉 。 如 果 忘记 了 捕捉 异常 ， 
则 该 异常 将 会 上 行 至 调用 栈 , 终止 线程 的 执行 并 显示 相应 消息 (并 以 此 提醒 用 户 )， 如 
图 2.10 所 示 。 














产生 错误 的 方法 

RD RRA 
的 方法 

包含 异常 处 理 


的 方法 


未 捕捉 异常 ， 因 而 终止 
线程 执行 


v 
it 


FA 2.10 
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Java 内 建 了 强大 的 异常 机 制 ， 多 数 时 候 会 强制 开发 人 员 显 式 地 标注 可 能 会 抛 出 异常 的 


函数 ， 同 时 显 式 地 通过 try…catch 代码 块 捕捉 各 个 异常 (检查 型 异常 )。 这 对 了 





说 工作 良好 ， 但 在 大 型 应 用 程序 中 ， 这 通常 会 产生 元 余 代码 ， 如 下 所 示 : 


// Java 

try ( 
doSomething () 

} catch (IOException e) { 
// Must be safe 








) 








FF 小 型 项 目 来 


如 果 未 将 异常 传递 至 调用 栈 ， 则 可 通过 空 catch 块 对 其 进行 忽略 。 因 此 ， 异 常 将 无 法 被 











正常 处 理 并 于 随后 消失 。 此 类 代码 会 掩盖 某 些 较为 重要 的 问题 ， 同 时 会 带 来 安 
在 讨论 Kotlin 的 异常 处 理 机 制 之 前 ， 下 面 首 先 比较 一 下 两 种 类 型 的 异 ? 
所 示 。 
表 2.4 
代码 检查 型 异常 非 检查 型 异常 


函数 声明 | 需要 通过 函数 确定 所 抛 出 的 异常 内 容 


抛 出 异常 的 函数 应 位 于 try-…cateh 代码 | 捕 所 异常 ， 并 根据 需要 执行 
sid mu 


Kotlin 和 Java 异常 机 制 之 间 最 大 的 差异 是 ， 在 Kotlin 中 ， 全 部 异常 均 为 








全 问题 。 
常 ， 如 表 2.4 


函数 声明 不 包含 与 抛 出 异常 相关 的 信息 


相关 操作 ， 


但 这 并 非 是 强制 要 求 。 异 常 将 上 行 至 调 


FE 检查 型 ， 这 


也 意味 着 ， 无 须 利 用 try…catch 包围 某 个 方法 ， 即 使 这 是 一 个 Java 方法 且 有 可 能 抛 出 被 捕 





捉 的 异常 。 如 下 所 示 : 


fun foo() { 
throw IOException() 
) 


fun bar() ( 
foo () // no need to surround method with try-catch block 
H 


该 方案 解决 了 代码 元 余 问 题 ， 并 改善 了 安全 性 ， 即 无 须 引 入 空 的 catch 块 。 
Kotlin 的 try…catch 代码 块 等 同 于 Java 的 try…catch 代码 块 ， 如 下 所 示 ; 


fun sendFormData (user: User?, data: Data?) ( // 1 
user ?: throw NullPointerException ("User cannot be null") 
VU? 
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data ?: throw NullPointerException("Data cannot be null") 


//do something 
} 


fun onSendDataClicked() ( 
Ery NE 3 
sendFormData (user, data) 
) catch (e: AssertionError) ( // 4 
// handle error 
) finally ( // 5 
// optional finally block 
) 
H 


。 在 注释 1 中 ， 异 常 未 在 函数 签名 中 设置 ， 这 一 点 与 Java 类 似 。 


e 在 注释 2 中 ， 检 查 了 数据 的 有 效 性 ， 并 抛 出 NullPointerException 〈 注 意 ， 当 创建 新 


的 对 象 实例 时 ， 无 须 使 用 new 关键 字 )。 
e 在 注释 3 中 ，try…catch 代码 块 类 似 于 Java 中 的 对 应 结构 。 
o 在 注释 4 中 ， 仅 处 理 特定 异常 〈 即 AssertionError 异常 )。 
e 在 注释 S 中 ， 总 是 执行 finally 代码 块 。 








相应 地 ,可 能 会 忽略 0 或 多 个 catch 和 finally 代码 块 ,但 至 少 应 设置 一 个 catch 或 finally 


代码 块 。 








在 Kotlin 中 ， 异 常 处 理 try 定义 为 一 个 表达 式 ， 因 而 可 返回 一 个 值 ， 并 将 其 赋予 某 个 


变量 中 。 实 际 赋值 结果 通常 是 所 执行 的 代码 块 的 最 后 一 个 表达 式 。 下 列 示 例 显示 了 特定 的 














Android 应 用 程序 是 否 已 经 安装 在 当前 设备 中 。 
val result = try ( // 1 








context .packageManager.getPackageInfo("com.text.app", 0) // 2 


true 


} catch (ex: PackageManager.NameNotFoundException) { // 3 


false 
} 


e try…catch 代码 块 表示 为 独立 表达 式 函数 所 返回 的 返回 值 














e 如 应 用 程序 已 安装 完毕 ，getPackageInfo 将 返回 一 个 值 ( 该 值 被 忽略 )， 包 含 true K 
达 式 的 下 一 行 代码 将 被 执行 。 这 也 是 wy 代码 块 所 执行 的 最 后 一 项 操作 ， 因 而 其 值 











将 被 赋予 至 某 个 变量 中 (true)。 





























车 应 用 程序 尚未 安装 ，getPackageInfo 将 抛 出 PackageManager.NameNotFoundException, 并 


执行 catch 代码 块 。 HH, catch 代码 块 的 最 后 一 行 包含 了 false 表达 式 ， 








因而 其 值 将 被 赋予 
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至 某 个 变量 


2.11 编译 期 常量 











于 val 变量 具有 只 读 性 质 ， 因 而 在 大 多 数 时 候 ， 可 将 其 视 作 常量 。 需 要 注意 的 是 ， 
其 初始 化 过 程 可 能 会 被 延迟 。 这 也 表明 ， 某 些 时 候 ，val 变量 可 能 不 会 在 编译 期 内 被 初始 
化 。 例 如 ， 将 当前 方法 的 结果 值 赋予 某 个 变量 ， 如 下 所 示 : 


val fruit:String = getName () 


该 值 将 在 运行 期 内 被 赋值 。 因 此 ， 有 时 需要 了 解 编译 期 内 该 值 的 具体 内 容 。 当 需要 将 
参数 传递 至 注解 中 时 ， 方 需要 使 用 到 实际 值 。 这 里 ， 注 解 由 注解 处 理 器 进行 操作 ， 并 在 应 
用 程序 启动 之 前 即 开始 运行 ， 如 图 2.11 所 示 。 


[e 解析 并 输入 meum | BI — a) - 
1010 


El 2.11 


为 了 确保 对 应 值 在 编译 期 已 知 (进而 可 被 注解 处 理 器 予以 处 理 )， 需 要 利用 const 修饰 
符 对 其 进行 标记 。 下 面 定 义 一 个 注解 类 MyLogger， 并 利用 单一 参数 定义 最 大 日 志 项 ， 并 
以 此 对 Test 类 进行 注解 ， 如 下 所 示 : 
const val MAX LOG ENTRIES = 100 
@MyLogger (MAX LOG ENTRIES ) 


// value available at compile time 
class Test {} 


关于 const 的 使 用 ， 存 在 一 些 限制 条 件 ， 读 者 须 对 此 有 所 了 解 。 首 先 ， 须 采用 基本 类 
型 或 String 类 型 进行 初始 化 。 其 次 ， 须 在 代码 最 上 方 或 作为 对 象 成 员 予 以 声明 ， 第 4 章 将 
对 此 加 以 讨论 。 最 后 ， 对 应 内 容 无 法 包含 自 定义 getter 方法 。 


212 委托 机 制 


Kotlin 针对 委托 机 制 提供 了 强 有 力 的 支持 ， 与 Java 相 比 ， 这 一 点 得 到 了 明显 的 改善 。 
若 情况 属实 ，Android 开发 过 程 中 可 实现 大 量 的 委托 应 用 程序 ， 第 8 章 将 对 此 予以 解释 。 
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2.13 本 章 小 结 


本 章 讨 论 了 变量 、 值 以 及 常量 之 间 的 差别 ， 同 时 还 涉及 了 Kotlin 中 的 基本 数据 类 
型 (包括 范围 )。 除 此 之 外 ， 本 章 还 介绍 了 Kotlin 的 类 型 机 制 〈 严 格 的 空 安全 检测 )， 
以 及 可 空 引 用 的 处 理 方式 (通过 各 种 操作 符 和 智能 转换 )。 通 过 类 型 引用 和 各 种 控制 结 
Kj (Kotlin 将 其 视 为 表达 式 )， 可 编写 更 加 简洁 的 代码 。 最 后 ， 本 章 还 考察 了 异常 的 处 
理 方式 。 

第 3 章 将 讨论 函数 及 其 不 同 的 定义 方式 ， 同 时 还 将 探讨 单一 表达 式 函数 、 默 认 参 数 、 
命名 参数 语法 以 及 各 种 修饰 符 。 
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第 2 章 介 绍 了 Kotlin 变量 、 类 型 机 制 以 及 控制 结构 。 当 构建 应 用 程序 时 ， 还 须 使 用 到 
构造 块 以 定义 各 种 结构 。 在 Java 中 ， 类 表示 为 代码 的 构造 块 ， 另 外 一 方面 ，Kotlin 支持 函 
数 编程 ,因而 可 在 不 使 用 类 的 情况 下 构建 程序 和 库 。 在 Kotlin H, 函数 是 最 基本 的 构造 块 ， 
本 章 主要 介绍 Kotlin 中 的 函数 ， 以 及 各 种 函数 特性 和 类 型 。 

本 章 主 要 涉及 以 下 内 容 : 

* Kotlin 中 基本 的 函数 应 用 。 

e Unit 返回 类 型 。 

e Vararg 参数 。 

e 单一 表达 式 函 数 。 

e 尾 递归 函数 。 

e 默认 参数 值 。 

e 命名 参数 值 。 

e 顶级 函数 。 

e 本 地 函数 。 

* Nothing 返回 类 型 。 


3.1 基本 的 函数 声明 和 应 用 
































“Hello World!” 是 测试 某 种 语言 的 最 为 常见 的 程序 ， 作 为 一 个 完整 程序 ， 对 应 结果 

将 在 控制 台中 显示 “Hello World!”。 同 样 ， 本 节 也 将 从 该 程序 开始 。Kotlin 程序 基于 某 

个 函数 且 仅 基于 函数 一 一 无 须 使 用 类 。 因 此 ，Kotlin 中 的 “Hello World!” 程 序 如 下 所 示 : 
// SomeFile.kt 


fun main(args: Array<String>) { // 1 
println("Hello, World!") // 2, Prints: Hello, World! 








) 
e 函数 定义 了 单一 参数 args， 其 中 包含 了 运行 当前 程序 的 参数 数组 〈 源 自命 令 行 )。 
同时 ， 参 数 定义 为 非 空 类 型 ， 当 程序 启动 且 不 包含 任何 参数 时 ， 空 数组 将 传递 至 
方法 中 。 
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eprinth 函数 则 是 定义 于 Kotlin 标准 库 中 的 函数 ， 等 价 于 Java 函数 中 的 System. 

out.println. 

该 程序 涵盖 了 Kotlin 中 的 诸多 特征 ， 例 如 函数 的 外 观 ， 且 无 须 使 用 任何 类 即 可 定义 函 
数 。 下 面 首先 分 析 函 数 的 结构 。 该 函数 始 于 关键 字 fun， 随 后 是 函数 名 以 及 括号 中 的 参数 
以 及 函数 体 。 下 列 简单 函数 将 返回 一 个 值 : 

fun double(i: Int): Int { 

return 2 * i 





























) 


人 们 常常 容易 混 消 方 法 与 函数 之 间 的 差异 。 一 般 定 义 如 下 所 示 : 
元 数 表示 为 一 个 代码 段 ， 并 通过 名 称 被 调用 。 方法 则 是 与 类 实例 ( 对 象 ) 
相关 联 的 函数 ， 有 时 也 称 作 成 员 函 数 。 
简单 地 讲 ， 类 中 的 函数 称 作 方法 。 在 Java P, 官方 仅 支持 方法 一 说 ,但 
在 学 术 环 境 中 ,静态 方 法 实际 上 即 是 函数 。 在 Kotlin 中 ， 函 数 定义 为 不 与 任 
何 对 象 关联 。 
1E Kotlin 中 ， 函 数 调用 的 语法 与 Java 以 及 大 多 数 现代 程序 设计 语言 相同 ， 如 下 所 示 : 
val a = double(5) 


代码 调用 了 double 函数 ,并 将 其 返回 值 赋予 某 个 变量 中 。 下 面 考察 Kotlin 函数 的 参数 和 返 
回 类 型 。 


3.1.1 参数 


Kotlin 函数 中 的 参数 采用 Pascal 标记 进行 声明 ， 各 个 参数 的 类 型 须 显 式 确定 。 另 外 
全 部 参数 均 定义 为 只 读 变量 。 同 时 ， 不 存在 相关 方法 可 对 参数 进行 修改 ， 此 类 行为 将 引发 
错误 操作 。 在 Java 语言 中 ， 程 序 员 常 对 此 加 以 滥用 。 如 果 确 有 此 类 需求 ， 可 显 式 地 对 参数 
予以 保护 ， 即 利用 相同 的 名 字 声 明 局 部 变量 ， 如 下 所 示 : 

fun findDuplicates(list: List«Int»): Set<Int> { 


var list - list.sorted() 
ume 














) 
上 述 代码 虽然 可 正常 工作 ， 但 却 是 一 种 较 差 的 操作 行为 ， 同 时 还 会 显示 一 条 警告 消息 。 一 
种 较 好 的 方法 是 根据 提供 的 数据 以 及 功能 命名 参数 和 变量 。 随 后 ， 对 应 名 称 应 在 大 多 数 时 
候 具 有 唯一 性 。 
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在 编程 社区 内 ， 实 参 和 形 参 通常 被 认为 是 一 种 事物 。 但 二 者 并 不 可 交换 
使 用 ， 其 原因 在 于 : 二 者 具有 不 同 的 含义 。 其 中 ， 实 参 表示 函数 调用 时 传递 
至 参数 的 实际 值 ; 形 参 则 表示 函数 声明 内 部 所 声明 的 变量 。 考 察 下 列 示例 : 


fun printSum(al: Int, a2: Int) ( // 1. 
q print(al + a2) 


) 
add(3, 5) // 2. 


1 - al and a2 are parameters 
2 - 3 and 5 are arguments 


类 似 于 Java, Kotlin 中 的 函数 可 包含 多 个 参数 ， 如 下 所 示 : 


fun printsum(a: Int, b: Int) { 
val sum - a * b 
print (sum) 

} 


函数 中 参数 可 以 是 参数 声明 类 型 的 子 类 型 。 如 前 所 述 ， 在 Kotlin 中 ， 所 有 非 空 类 型 的 
超 类 型 为 Any， 因 而 在 接受 全 部 类 型 时 ， 即 可 使 用 Any， 如 下 所 示 : 
fun presentGently(v: Any) ( 


println("Hello. I would like to present you: $v") 
) 


presentGently ("Duck") 

// Hello. I would like to present you: Duck 
presentGently (42) 

// Hello. I would like to present you: 42 


对 于 参数 为 null 这 一 类 情形 ， 类 型 须 定义 为 可 空 类 型 。 需 要 注意 的 是 ，Any? 表 示 为 全 
部 可 空 以 及 非 空 类 型 的 子 类 型 ， 因 而 可 传递 任意 类 型 的 对 象 作为 参数 ， 如 下 所 示 : 


fun presentGently(v: Any?) { 
println("Hello. I would like to present you: $v") 





) 


presentGently (null) 

// Prints: Hello. I would like to present you: null 
presentGently (1) 

// Prints: Hello. I would like to present you: 1 
presentGently ("Str") 

// Prints: Hello. I would like to present you: Str 
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3.1.2 ”返回 函数 


截止 到 目前 ， 大 多 数 函 数 均 采用 类 似 于 过 程 的 方式 加 以 定义 〈 不 返回 任何 值 的 函数 )。 
实际 上 ，Kotlin 中 不 包含 任何 过 程 ， 全 部 函数 均 返 回 某 个 值 。 若 未 加 指定 ， 默 认 返 回 值 为 
Unit 实例 。 出 于 演示 目的 ， 下 面 对 其 进行 显 式 设置 : 

fun printSum(a: Int, b: Int): Unit ( // 1 


val sum - a * b 
print (sum) 




















) 


与 Java 不 同 ，Kotlin 可 在 函数 名 以 及 参数 之 后 定义 返回 类 型 。 

Unit 对 象 等 价 于 Java 中 的 void, 但 也 可 视 为 任意 其 他 对 象 , 因而 可 将 其 存储 于 变量 中 ， 
如 下 所 示 : 

val p = printsum(1, 2) 

println(p is Unit) // Prints: true 
74/5, Kotlin 编码 规则 指出 ， 当 函数 返回 Unit 时 ， 那 么 ， 类 型 定义 应 被 忽略 。 通 过 这 一 方 
式 ， 代 码 变 得 更 具 可 读 性 且 易 于 理解 ， 如 下 所 示 : 

fun printsum(a: Int, b: Int) { 


val sum = a + b 
print (sum) 

















Unit 定义 为 单 例 对 象 ， 也 就 是 说 ， 仅 存在 单一 Unit 实例 。 因 此 ， 下 列 3 


个 条 件 均 为 true: 
qp println(p is Unit) // Print: true 


println(p -- Unit) // Print: true 
println(p === Unit) // Print: true 


Kotlin 支持 单 例 模式 ， 第 4 章 将 对 此 加 以 讨论 。 
当 采 用 Unit 返回 类 型 从 函数 中 返回 输出 结果 时 ， 可 简单 地 使 用 不 包含 任何 值 的 retum 
语句 ， 如 下 所 示 : 


fun printSum(a: Int, b: Int) { // 1 
afia <0) Ibo) t 
return // 2 
H 
val sum - a * b 
print (sum) 
VUES. 


























e 在 注释 1 中 ， 未 设 定 任何 返回 类 型 ， 因 而 返回 类 型 隐 式 地 设置 为 Unit. 
e 在 注释 2 中 ， 可 使 用 不 包含 任何 值 的 retum 语句 。 
e “ŽORE Unit 时 ，returm 调用 为 可 选项 。 
除 此 之 外 ， 还 可 返回 Unit， 但 这 通常 会 导致 误解 且 缺 乏 可 读 性 ， 因 而 不 建议 使 
当 制 定 返回 类 型 时 ， 除 了 Unit 之 外 ， 通 常 还 会 显 式 地 返回 值 ， 如 下 所 示 : 
fun sumPositive(a: Int, b: Int): Int ( 

if(a » 0 && b » 0) ( 

return a * b 


) 
// Error, 1 























o 














} 


在 注释 1 中 ， 函 数 并 不 会 对 其 进行 编译 ， 其 原因 在 于 : 未 指定 返回 值 ， 且 if RERE 
满足 。 
通过 添加 第 二 条 retum 语句 ， 即 可 解决 当前 问题 ， 如 下 所 示 : 
fun sumPositive(a: Int, b: Int): Int { 
if(a >= 0 && b >= 0) ( 
return a * b 


} 
return 0 


3.2 vararg 参数 


某 些 时 候 ， 参 数 的 数量 事先 未 知 。 此 时 ， 可 向 参数 添加 一 个 vararg 修饰 符 ， 进 而 使 函 
数 可 接收 任意 数量 的 参数 。 例 如 ， 下 列 函数 将 输出 多 个 整数 之 和 。 


fun printsum(vararg numbers: Int) { 
val sum = numbers.sum() 
print (sum) 

} 


printSum(1,2,3,4,5) // Prints: 15 

printsum() // Prints: 0 

参数 可 在 方法 内 部 作为 加 载 全 部 数值 的 数组 予以 访问 。 其 中 ， 数 组 类 型 对 应 于 vararg 
参数 类 型 。 正 常 状态 下 ， 期 望 为 加 载 特定 类 型 的 泛 型 数组 (Array<T> ); 然而 ，Kotlin 针对 
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而 应 使 用 该 类 型 的 数组 .下 列 示例 表示 为 包含 String 


Ea 





Int 数 组 定义 了 优化 类 型 , 即 IntArray， 
类 型 的 vararg 参数 。 

fun printAll(vararg texts: String) ( 

// Inferred type of texts is Array<String> 


val allTexts = texts.joinToString(",") 
println("Texts are $allTexts") 








} 
printAll("A", "B", "C") // Prints: Texts are A,B,C 
注意 ， 可 在 vararg 参数 前 、 后 确定 多 个 参数 ， 且 参数 之 间 需 要 一 一 对 应 ， 如 下 所 示 : 


fun printAll(prefix: String, postfix: String, vararg texts: String) 
{ 









val allTexts = texts.joinToString(", ") 
println("$prefix$allTexts$postfix") 
) 


printAll("All texts: ", "!") // Prints: All texts: ! 
printAll("All texts: ","!" , "Hello", "World") 
// Prints: All texts: Hello, World! 


除 此 之 外 ， 提 供与 vararg 形 参 的 实际 参数 应 为 特定 类 型 的 子 类 型 ， 如 下 所 示 : 


fun printAll(vararg texts: Any) { 
val allTexts - texts.joinToString(",") // 1 
println (allTexts) 

) 


// Usage 

PriotALL("A™; 1, tet) Wh Prints: A, MAC 
在 注释 1 中 , joinToString 可 在 列表 上 被 调用 ， 并 将 各 元 素 连接 为 一 个 独立 的 字符 呈 
一 个 参数 上 ， 定 义 了 一 个 分 隔 符 。 

在 每 个 函数 声明 中 , 仅 可 存在 一 个 vararg 参数 , 这 也 是 vararg 应 用 时 的 一 个 限制 条 件 。 

当 调 用 vararg 参数 时 ， 可 逐一 传递 参数 值 ， 但 也 可 传递 值 数组 。 这 可 通过 spread 操作 
ESL CHARA), AR tas: 


val texts = arrayOf("B", "c", "p*") 
printAll(*texts) // Prints: Texts are: B,C,D 
printAll("A", *texts, "E") // Prints: Texts are: A,B,C,D,E 


pn 


。 在 第 
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在 典型 的 程序 设计 过 程 中 ， 许 多 函数 仅 包 含 一 个 表达 式 ， 如 下 所 示 : 


fun square(x: Int): Int ( 
return x * £ 




















} 
另 一 个 例子 则 常见 于 Android 项 目 中 ， 并 采用 了 Activity 中 的 一 种 模式 ， 相 关 方 法 从 
视图 中 获取 文本 ， 或 者 从 视图 中 提供 其 他 数据 以 供用 户 使 用 ， 如 下 所 示 : 


fun getEmail(): String { 
return emailView.text.toString() 

















) 





上 述 两 个 函数 均 返 回 单 表达 式 。 在 第 一 个 示例 中 ， 返 回 值 表 示 为 x * x 乘法 运算 结果 ; 
在 第 二 个 示例 中 , 返回 结果 为 emailView.text.toString()。 这 一 类 函数 常用 于 Android 项 目 中 ， 
其 中 包括 : 

e 获取 某 些小 型 操作 (例如 之 前 的 square 函数 )。 

e 使 用 多 态 向 某 个 特定 类 提供 数值 。 

e 仅 用 于 生成 某 个 对 象 的 函数 。 

e 在 体系 结构 层 之 间 传 递 数据 的 函数 例如，Activity 在 视图 和 用 户 之 前 传递 数据 )。 

e 基于 递归 的 函数 式 编程 风格 函数 。 

此 类 函数 经 常会 使 用 到 , 因而 针对 此 类 函数 设置 了 对 应 标记 。 当 函数 返回 单 表达 式 时 ， 
则 可 忽略 花 括 号 和 函数 体 。 采 用 这 一 方式 定义 的 函数 称 作 单 表达 式 函数 。 下 面 更 新 square 
函数 ， 并 将 其 定义 为 单 表 达 式 函数 ， 如 图 3.1 所 示 。 






































包含 表达 式 体 的 函数 声明 
| fun square(x:Int):Int -x'x ] 
表达 式 体 
包含 代码 块 体 的 函数 声明 
| fun square(x:Int):Int ( 
return x'x 代码 块 体 
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不 难 发 现 ， 单 表达 式 函 数 包含 表达 式 体 ， 而 非 代码 块 体 。 该 符号 更 为 短小 ， 但 整体 仅 为 一 
个 单 表达 式 。 

在 单 表达 式 函数 中 ， 声 明 返 回 类 型 则 视 为 可 选项 一 一 编译 器 可 通过 表达 式 类 型 进行 推 
断 ， 进 而 简化 了 square。 对 应 的 定义 方式 如 下 所 示 : 


fun square(x: Int) - x * x 


在 Android 项 目 中 ， 单 表达 式 函 数 十 分 常见 。 下 面 考察 RecyclerView 适配器 ， 用 于 提 
供 布局 ID 并 创建 ViewHolder， 如 下 所 示 : 


class AddressAdapter : ItemAdapter<AddressAdapter.ViewHolder>() { 
override fun getLayoutId() = R.layout.choose address view 
override fun onCreateViewHolder(itemView: View) = 
ViewHolder (itemView) 















































// Rest of methods 
) 


在 下 面 的 示例 中 ， 在 单 表 达 式 函数 的 基础 上 ， 实 现 了 有 具有 较 好 可 读 性 的 编码 内 容 。 另 
外 ， 单 表达 式 函数 在 函数 式 编程 中 也 十 分 常见 ， 稍 后 将 讨论 具体 示例 ( 即 尾 递归 函数 )。 
同时 ， 单 表达 式 函 数 还 可 与 when 结构 协同 使 用 。 下 列 代 码 实现 了 这 种 连接 方式 ， 并 根据 
键 值 从 对 象 中 获取 特定 数据 。 
fun valueFromBooking(key: String, booking: Booking?) = when(key) ( 
d at 
"patient.nin" -> booking?.patient?.nin 
"patient.email" -» booking?.patient?.email 
"patient.phone" -» booking?.patient?.phone 
"comment" -» booking?.comment 


else -» null 
) 


此 处 并 不 需要 定义 某 个 类 型 ， 对 应 类 型 可 从 when 表达 式 中 进行 推断 。 
另 一 个 常见 的 Android 示例 则 是 结合 使 用 when 表达 式 以 及 activity onOptionsItem 
Selected， 进 而 处 理 上 方 工具 栏 的 单 击 操作 ， 如 下 所 示 : 


override fun onOptionsItemSelected(item: MenuItem) : Boolean = when 
t 











item.itemId == android.R.id.home -> ( 
onBackPressed() 
true 


} 
else -> super.onOptionsItemSelected (item) 
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另 一 个 体现 单 表达 式 函 数 作用 的 示例 则 是 ， 在 独立 对 象 上 链接 多 项 操作 ， 如 下 所 示 : 
fun textFormatted(text: String, name: String) = text 

.trim() 

-capitalize() 

-replace("{name}", name) 
val formatted = textFormatted("hello, {name}", "Marcin") 
println(formatted) // Hello, Marcin 


不 难 发 现 ， 单 表达 式 函 数 使 代码 更 加 简洁 ， 并 改善 了 代码 的 可 读 性 。 单 表达 式 函 数 常 用 于 
Kotlin Android 项 目 中 ， 并 且 在 函数 式 编程 中 十 分 常见 。 


命令 式 编程 和 声明 式 编程 
命令 式 编程 范例 描述 了 所 需 的 实际 步骤 序列 ， 进 而 执行 某 项 操作 。 对 于 
大 多 数 程序 员 来 讲 ， 这 种 方式 较为 直观 。 
qp 声明 式 编程 范例 描述 了 期 望 结果 ， 但 无 须 按 照 各 步骤 予以 实现 ( 行为 实 
H) 这 也 表明 ,程序 通过 表达 式 或 声明 完成 ， 而 非 语句 。 函 数 式 和 逮 辑 式 编 
程 均 具有 显著 的 声明 式 程序 设计 风格 。 与 命令 式 编程 相 比 ， 声 明 式 编程 更 加 
短小 ， 且 具有 较 好 的 可 读 性 。 




















3.4 尾 递 归 函 数 





递归 函数 是 指 实现 了 自身 调用 的 函数 ， 下 面 考察 递归 函数 getState。 
fun getState(state: State, n: Int): State - 

if (n <= 0) state // 1 

else getState(nextState(state), n - 1) 


递归 是 函数 式 编程 中 的 重要 内 容 , 但 每 次 递归 调用 需要 在 栈 中 保存 上 一 个 函数 的 返 区 
地 址 。 当 应 用 程序 深度 递归 时 〈 栈 中 存在 大 量 的 函数 )， 将 会 抛 出 StackOverflowError。 这 
也 是 递归 应 用 中 较为 严重 的 一 个 问题 。 

针对 这 一 问题 ， 经 典 的 解决 方案 是 使 用 欠 代 ， 而 非 递 归 ， 但 前 者 的 表达 性 较 差 ， 如 下 
所 示 : 


fun getState(state: State, n: Int): State { 
var state = state 
Por (un und vnm 
state = state.nextState() 
} 
return state 
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对 此 ， 一 种 较 好 方法 是 尾 递归 函数 ， 诸 如 Kotlin 等 现代 编程 语言 均 对 此 予以 支持 。 尾 
递归 函数 是 一 种 特殊 的 递归 函数 , 其中, 函数 在 执行 最 后 一 次 操作 时 调用 自身 ( 换 而 言 之 ， 
递归 发 生 在 函数 的 最 后 一 次 操作 )。 这 可 通过 编译 器 优化 递归 调用 ， 并 以 更 加 高 效 的 方式 
执行 递归 操作 , 而 无 须 担 心 潜在 的 StackOverflowError。 当 实现 函数 尾 递归 时 , 须 使 用 tailrec 
修饰 符 对 其 进行 标记 ， 如 下 所 示 : 

tailrec fun getState(state: State, n: Int): State = 

if (n <= 0) state 
else getState(state.nextState(), n - 1) 

为 了 进一步 检测 尾 递归 的 工作 方式 ， 可 对 代码 进行 编译 、 反 编译 操作 ， 如 下 所 示 〈 简 
化 后 的 代码 ): 

public static final State getState(@NotNull State state, int n) 

t 





























while(true) ( 

| 
return state; 

} 
state = state.nextState(); 
noun — iy 

} 

} 


.EXRSENHUEE T GRIOBME, DANAE EB Ell. J fil tailrec 正常 工作 ， 须 满足 某 些 需 
求 条 件 ， 其 中 包括 : 

e 函数 须 在 执行 最 后 一 次 操作 时 调用 自身 。 

e 不 可 在 try/catch/finally 块 中 使 用 。 

e 在 本 书 编写 时 ， 仅 支持 将 Kotlin 编译 为 JVM。 


3.5 调用 函数 的 不 同方 式 

















在 某 些 场合 下 ， 需 要 调用 某 个 函数 ， 并 通过 所 选 参数 。 在 Java 中 ， 可 创建 同一 方法 的 
多 个 重 载 方法 ， 但 该 方案 包含 某 些 局 限 性 。 第 一 个 问题 是 ， 既 定 方法 的 排列 数量 增长 十 分 
迅速 《27)， 进 而 难以 实现 有 效 的 管理 。 第 二 个 问题 是 ， 重 载 方法 之 间 彼 此 难以 区 分 。 编 译 
器 可 能 知晓 调用 哪 一 个 重 载 方法 ， 但 当 某 个 方法 定义 了 包含 相同 类 型 的 多 个 参数 时 ， 则 无 
法 进一步 定义 相应 的 重 载 方法 。 这 也 是 为 什么 常常 需要 向 某 个 方法 中 传递 多 个 null 值 的 原 
因 ， 如 下 所 示 : 


// Java 
printValue("abc", null, null, "!"); 
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上 述 方法 极 大 地 降低 了 代码 的 可 读 性 。 在 Kotlin 中 ， 此 类 问题 不 复 存在 。Kotlin 包含 了 默 
认 参 数 和 命名 参数 语法 这 一 类 特征 。 


3.5.1 ”默认 参数 值 


默认 参数 在 C++ 中 体现 的 较为 明显 ， 一 些 较为 古老 的 编程 语言 也 对 此 予以 支持 。 默 认 
参数 向 参数 提供 了 一 个 值 ， 以 防 在 方法 调用 其 间 参 数 缺失 。 每 个 函数 参数 均 包含 了 一 个 默 
认 值 ， 可 能 是 与 特定 类 型 相 匹配 的 任意 值 ， 包 括 null。 据 此 ， 可 简单 地 定义 函数 ， 并 可 通 
过 多 种 方式 对 其 加 以 调用 。 下 列 代码 显示 了 包含 默认 值 的 函数 示例 。 


fun printValue(value: String, inBracket: Boolean = true, 
prefix: String = "". suffix: String) = "") t 
print (prefix) 
if (inBracket) { 
print ("(${value})") 
} else { 
print (value) 























) 
println (suffix) 
) 


通过 向 各 个 参数 提供 数值 ， 该 函数 的 使 用 方式 与 常规 函数 〈 未 包含 默认 值 的 函数 ) 并 无 两 
样 ， 如 下 所 示 : 
printValue("str", true, "","") // Prints: (str) 
对 于 默认 参数 值 ， 可 仅 向 不 包含 默认 值 的 参数 提供 数据 ， 进 而 调用 某 个 函数 ， 如 下 所 示 : 
printValue("str") // Prints: (str) 
相应 地 ， 还 可 提供 没有 默认 值 的 全 部 参数 ， 或 者 只 有 某 些 参 数 包含 默认 值 ， 如 下 
所 示 : 


printValue("str", false) // Prints: str 





3.5.2 ”命名 参数 语法 


有 时 , 仅 须 向 最 后 一 个 参数 传递 数值 。 假 设 针 对 后 绥 定 义 一 个 值 , 而 非 前 级 和 inBracket 
(已 在 前 级 之 前 加 以 定义 )。 正 常情 况 下 ， 须 针对 之 前 的 所 有 参数 提供 相应 值 ， 包 括 默 认 参 
数值 ， 如 下 所 示 : 


printValue("str", true, true, "!") // Prints: (str) 
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通过 命名 参数 语法 ， 可 通过 参数 名 传递 特定 的 参数 ， 如 下 所 示 : 


printValue("str", suffix = "!") // Prints: (str)! 


这 将 支持 更 为 灵活 的 语法 形式 。 当 调用 某 个 函数 时 ， 仅 提供 所 选 参数 即 可 。 考 虑 到 代码 的 
可 读 性 ， 该 形式 常用 于 确定 参数 的 真正 含义 ， 如 下 所 示 : 
printValue("str", inBracket = true) // Prints: (str) 
printValue("str", prefix - "Value is ") // Prints: Value is str 
printValue("str", prefix - "Value is ", suffix - "!! ") 
// Prints: Value is str!! 


只 要 提供 了 不 包含 默认 值 的 全 部 参数 ， 即 可 采用 命名 参数 语法 并 以 任意 顺序 设置 所 需 
参数 。 另 外 ， 参 数 的 顺序 具有 一 定 的 相关 性 ， 如 下 所 示 : 

printValue("str", inBracket- true, prefix = "Value is ") 

// Prints: Value is (str) 


printValue("str", prefix - "Value is ", inBracket- true) 
// Prints: Value is (str) 


其 中 ， 参 数 的 顺序 有 所 不 同 ， 但 两 条 语句 的 调用 彼此 等 价 。 

另外 ， 还 可 将 命名 参数 语法 与 常规 调用 结合 使 用 。 唯 一 的 限制 条 件 是 : 如 果 使 用 命名 
语法 ， 则 无 法 针对 下 一 个 参数 再 次 使 用 ， 如 下 所 示 : 

printValue ("str", true, "") 

printValue ("str", true, prefix - "") 

printValue ("str", inBracket = true, prefix = "") 


printValue ("str", inBracket true, "") // Error 
printValue ("str", inBracket true, prefix = "=", "hj JJ Error 


该 特性 可 通过 更 加 灵活 的 方式 调用 相关 方法 ， 且 无 须 定义 多 个 重 载 方法 。 

对 于 Kotlin 参数 ， 命 名 参数 语法 还 具有 额外 的 特征 。 需 要 注意 的 是 ， 当 改变 某 个 参数 
名 时 ， 由 于 该 名 称 可 能 会 用 于 其 他 项 目 中 ， 因 而 将 会 产生 错误 。Android Studio 对 此 十 分 
关注 ， 如 果 通 过 内 建 重 构 工 具 对 参数 名 称 进行 重 命名 ， 该 操作 仅 可 工作 于 当前 项 目 中 。 当 
使 用 命名 参数 语法 时 ，Kotlin 库 生 成 器 一 般 会 对 此 予以 谨慎 处 理 。 参 数 名 称 的 改变 会 对 APT 
产生 负面 影响 。 注 意 ， 当 调用 Java 函数 时 ， 命 名 参数 语法 将 无 法 继续 使 用 一 一 Java 字 节 码 
不 会 保留 函数 参数 名 称 。 






























































3.6 MA BR 


通过 观察 可 知 ， 在 “Hello, World!” 程 序 中 ，main 函数 未 设置 于 任何 类 中 。 第 2 章 曾 
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提 到 ，Kotlin 可 在 顶级 (top-level) 位 置 处 定义 各 种 实体 。 相 应 地 ， 定 义 于 顶级 位 置 处 的 函 
数 称 作 顶 级 函数 ， 如 下 所 示 : 


// Test.kt 
package com.example 


fun printTwo() ( 
print (2) 
) 


顶级 函数 可 用 于 代码 的 任何 地 方 ， 其 调用 方式 与 局 部 函数 相同 。 当 访问 顶级 函数 时 ， 





须 通过 import 语句 显 式 地 将 其 导入 至 文件 中 。 在 Android Studio 中 ， 函 数 将 显示 于 提示 列 


Ky 














h， 当 函数 被 选择 (使 用 ) 后 , 将 自动 添加 导入 。 下 列 代码 在 Test.kt 中 定义 了 顶级 函数 ， 











并 在 Main.kt 文件 中 对 其 加 以 使 用 。 


// Test.kt 
package com.example 


fun printTwo() { 
print (2) 
} 


// Main.kt 
import com.example.printTwo 


fun main(args: Array<String>) { 
printTwo () 
} 


尽管 顶级 函数 十 分 有 用 ， 但 仍 须 对 其 予以 理智 使 用 。 定 义 公有 型 顶级 函数 将 会 增加 代 








码 提 示 列 表 中 函数 的 数量 〈 这 里 ， 提 示 列 表 是 指 ， 当 编写 代码 时 ，IDE 所 建议 的 提示 方法 
列表 )。 如 果 项 级 函数 名 称 未 了 予 清晰 定义 ， 则 会 与 本 地 对 应 函数 相 混淆 。 以 下 内 容 是 与 顶 
级 函数 相关 的 一 些 较 好 的 示例 : 


factorial。 
maxOf fil minof. 
listof. 
println. 


而 下 列 函 数 则 是 较 差 的 顶级 函数 示例 : 


e sendUserData. 
e showPossiblePlayers. 
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这 一 规则 仅 适用 于 Kotlin 面向 对 象 程序 设计 项 目 。 在 面向 函数 的 程序 设计 项 目 中 ,此 
类 名 称 均 为 有 效 的 顶级 函数 名 称 。 但 是 ， 此 处 假设 几乎 所 有 的 函数 均 在 顶层 定义 的 ， 而 不 
是 在 方法 中 定义 的 。 
通常 ， 函 数 可 定义 在 特定 的 模块 或 特定 类 中 。 为 了 限制 函数 的 可 见 性 〈 可 用 范围 )， 
可 使 用 相应 的 可 见 性 修饰 符 ， 第 4 章 将 对 此 加 以 讨论 。 


3.7 顶级 函数 的 底层 机 制 


















































对 于 Android 项 目 ，Kotlin 编译 为 Java 字 节 码 ， 并 运行 于 Dalvik 虚拟 机 CAndroid 5.0 
之 前 ) 或 Android 运行 期 (Android 5.0 之 后 的 版 本 )， 两 种 虚拟 机 仅 执 行 定义 于 类 中 的 代 
码 。 针 对 这 一 问题 ，Kotlin 编译 器 针对 顶级 函数 生成 类 。 相 应 地 ， 类 名 根据 文件 名 以 及 Kt 
后 组 构造 。 在 这 样 的 类 中 ， 全 部 函数 和 属性 均 为 静态 。 例 如 ， 假 设 在 Printerkt 文件 中 定义 
了 下 列 函 数 : 

// Printer.kt 

fun printTwo() { 


print (2) 
} 


Kotlin 代码 将 编译 为 Java 字 节 码 。 其 中 ,所 生成 的 字 节 码 类 似 于 下 列 Java 类 中 生成 的 代码 : 


// Java 
public final class PrinterKt ( // 1 
public static void printTwo() ( // 2 
System.out.print(2); // 3 








) 

) 

e 对 注释 1, PrinterKt 表示 为 基于 文件 名 和 Kt Je A EI AR o 

e 对 注释 2， 全 部 顶级 函数 和 属性 均 编 译 为 静态 方法 和 变量 。 

e 对 注释 3, print 定义 为 Kotlin 函数 ， 但 作为 内 联 函数 ， 在 编译 期 内 ， 其 调用 被 函数 
体 所 蔡 代 。 其 中 ， 函 数 体 仅 包含 System.out.println 调用 。 
第 5 章 将 对 内 联 函数 加 以 讨论 。 
在 Java 字 节 码 级 别 ，Kotlin 将 包含 更 多 数据 (例如 参数 名 )。 另 外 ， 利 用 类 名 添加 函 
数 调用 前 级， 还 可 从 Java 文件 中 访问 Kotlin 顶级 函数 ， 如 下 所 示 : 

// Java file, call inside some method 

PrinterKt.printTwo() 
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通过 这 种 方式 ， 可 全 方位 支持 Java 中 的 Kotlin 顶级 函数 调用 。 不 难 发 现 ，Kotlin 5j Java 
之 间 可 实现 彼此 协作 。 为 了 在 Java 中 更 加 方便 地 使 用 Kotlin 顶级 函数 ， 可 添加 注解 
(annotation)， 进 而 修改 JVM 生成 类 的 名 称 。 当 使 用 顶级 Kotlin 属性 以 及 Java 类 中 的 函数 
时 ， 这 将 十 分 方便 。 对 应 注解 如 下 所 示 : 
Gfile:JvmName ("Printer") 
在 文件 上 方 ， 须 添加 JvmName 注解 (在 包 名 之 前 )。 当 采取 这 一 方式 时 ， 生 成 类 的 名 称 将 
调整 为 Printer。 通 过 将 Printer 用 作 类 名 ， 即 可 在 Java 中 调用 printTwo 函数 ， 如 下 所 示 : 
// Java 
Printer.printTwo() 
有 些 时 候 , 顶级 函数 需要 在 独立 文件 中 加 以 定义 , 但 是 我 们 也 希望 它们 在 编译 到 TVM. 
之 后 出 现在 同一 个 类 中 。 对 此 ， 可 在 文件 上 方 使 用 下 列 注解 : 


Gfile:JvmMultifileClass 
例如 ， 假 设 希 望 利用 数学 帮助 函数 〈 源 自 Java) 创建 库 ， 可 定义 下 列 文件 : 


// Max.kt 

Gfile:JvmName ("Math") 
Gfile:JvmMultifileClass 
package com.example.math 


























fun max(nl: Int, n2: Int): Int = if(nl > n2) nl else n2 


// Min.kt 

Gfile:JvmName ("Math") 
Gfile:JvmMultifileClass 
package com.example.math 


fun min(nl: Int, n2: Int): Int = if(nl < n2) nl else n2 


随后 ， 可 通过 下 列 方式 从 Java 类 中 对 其 加 以 使 用 : 

Math.min(1, 2) 

Math.max(1, 2) 

据 此 ， 可 极 大 地 简化 文件 ， 同 时 保持 了 易 用 性 〈 从 Java 中 )。 

当 在 Kotlin 中 创建 库 ( 可 直接 用 于 Java 类 中 ) 时 ， 用 于 修改 生成 类 名 的 KmName 注 
解 十 分 有 用 ， 同 时 还 有 助 于 解决 名 称 冲 突 问题 。 当 创建 X.kt 文件 (包含 某 些 顶 级 函数 或 属 
TE) 以 及 同一 个 包 中 的 XKt 类 时 ， 即 会 出 现 命名 冲突 问题 。 根 据 现 有 规则 ， 类 名 不 应 包含 
Kt 后 级 ， 因 而 这 一 情况 基本 不 会 出 现 。 
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38 局 部 函数 


Kotlin 支持 多 种 环境 下 的 函数 定义 , 例如 顶级 函数 、 成 员 函 数 (位 于 类 、 接 口 等 内 部 )， 
以 及 其 他 函数 内 部 中 的 函数 (局 部 函数 )。 考 察 下 列 局 部 函数 定义 : 
fun printTwoThreeTimes() { 
fun printThree() ( // 1 
print (3) 
) 
printThree() // 2 
printThree() // 2 
) 


e 对 于 注释 1, printThree 表示 为 局 部 函数 ， 该 函数 位 于 另 一 个 函数 内 部 。 

e 对 于 注释 2， 局 部 函数 无 法 从 所 声明 的 函数 外 部 进行 访问 。 

在 局 部 函数 中 可 访问 的 元 素 不 需要 从 封闭 函数 中 作为 参数 传递 ， 因 为 可 对 其 直接 进行 
访问 。 例 如 : 


fun loadUsers(ids: List«Int») ( 
var downloaded: List«User» - emptyList() 








fun printLog(comment: String) ( 
Log.i("loadUsers (with ids $ids): $comment\nDownloaded: 
$downloaded") // 1 
m 
for(id in ids) ( 
printLog("Start downloading for id $id") 
downloaded += loadUser (id) 
printLog("Finished downloading for id $id") 


) 

















对 于 注释 1， 局 部 函数 可 访问 comment 参数 和 局 部 变量 (downloaded 和 ID )， 此 类 数据 定 
义 在 封闭 函数 内 部 。 
如 果 将 printLog 定义 为 项 级 函数 , 随后 须 作 为 参数 传递 ids 和 downloaded, 如 下 所 示 : 
fun loadUsers(ids: List«Int») ( 


var downloaded: List«User» = emptyList () 


for(id in ids) ( 
printLog("Start downloading for id $id", downloaded, ids) 
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downloaded += loadUser (id) 
printLog("Finished downloading for 
id $id", downloaded, ids)) 


} 


fun printLog(state: String, downloaded: List«User», ids: List<Int>) 
t 

Log.i("loadUsers (with ids $ids): 

$state\nDownloaded: downloaded") 
} 


上 述 实现 不 仅 匈 长 而 且 难 于 维护 。printLog 中 的 变化 要 求 使 用 不 同 的 参数 ， 而 参数 变 
化 则 需要 改变 函数 调用 中 的 参数 。 另 外 ， 如 果 调 整 printLog 中 的 loadUsers 参数 类 型 ， 同 
时 还 应 修改 printLog 中 的 参数 。 对 此 ， 如 果 printLog 定义 为 局 部 参数 ， 则 不 会 产生 任何 问 
题 。 这 也 解释 了 局 部 参数 的 应 用 时 机 : 获取 仅 供 单一 函数 使 用 的 功能 项 ， 且 对 应 功能 使 用 
了 该 函数 中 的 数据 元 素 〈 变 量 、 值 以 及 参数 )。 此 外 ， 局 部 函数 还 可 调整 局 部 变量 ， 如 下 
所 示 : 
fun makeStudentList(): List<Student> { 
var students: List<Student> = emptyList () 
fun addStudent (name: String, state: Student.State = 


Student.State.New) { 
students += Student(name, state, courses = emptyList()) 


























} 
Ul ese 
addStudent ("Adam Smith") 
addStudent ("Donald Duck") 
JU Nue 
return students 

) 


通过 这 种 方式 ， 可 获取 并 复 用 Java 中 无 法 得 到 的 某 些 功能 。 这 也 体现 了 局 部 函数 的 优势 : 
某 些 时 候 ， 局 部 函数 可 以 实现 其 他 方式 难以 完成 的 代码 析 取 工作 。 








3.9 无 返回 类 型 


有 时 需要 定义 一 个 仅 抛 出 异常 〈 非 正常 结束 ) 的 函数 ， 具 体 如 下 : 
e 函数 可 简化 错误 抛 出 机 制 。 在 某 些 库 中 ， 错 误 机 制 十 分 重要 ， 同 时 需要 对 其 提供 详 
细 的 信息 (具体 示例 参见 本 节 中 的 throwError 函数 )。 
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e 在 单元 测试 中 ， 某 些 函 数 用 于 抛 出 错误 。 当 在 代码 中 测试 错误 处 理 过 程 时 ， 这 将 十 
分 有 用 。 
针对 上 述 各 种 情形 ， 存 在 一 个 较为 特殊 的 类 ， 即 Nothing. Nothing 类 定义 为 空 类 型 ， 

且 不 存在 任何 实例 。 包含 Nothing 返回 类 型 的 函数 不 会 返回 任何 内 容 , 且 不 会 执行 到 retum 
语句 ， 并 仅仅 抛 出 一 个 异常 。 也 就 是 说 ， 函 数 仅 返回 Nothing， 且 抛 出 一 个 异常 。 通 过 这 
种 方式 ， 可 从 非 终止 函数 中 〈 返 回 Nothing) 区 分 某 些 非 返回 值 函数 〈 例 如 Java 中 的 void, 
以 及 Kotlin 中 的 Unit)。 下 面 考察 此 类 函数 示例 ， 进 而 可 用 于 简化 单元 测试 中 的 错误 抛 出 
机 制 。 


fun fail(): Nothing = throw Error() 


通过 使 用 定义 环境 (例如 类 或 函数 ) 中 的 数据 元 素 ， 可 构造 复杂 的 错误 消息 机 制 ， 如 
下 所 示 : 
fun processElement (element: Element) { 


fun throwError (message: String): Nothing 
7 throw ProcessingError("Error in element $element: $message") 



































Ui sac 
if (element.kind != ElementKind.METHOD) 
throwError("Not a method") 
Wl Bae 
} 


作为 一 种 替代 方案 ， 这 一 类 函数 可 像 throw 语句 一 样 使 用 ， 且 不 会 对 函数 返回 类 型 产 
生 任 何 影响 。 


fun getFirstCharOrFail(str: String): Char 
= if(str.isNotEmpty()) str[0] else fail() 





val name: String - getName() ?: fail() 


val enclosingElement = element.enclosingElement ?: throwError ("Lack of 

enclosing element") 

这 可 视 作 Nothing 类 的 特点 之 一 ， 就 好 像 它 是 所 有 可 能 类 型 的 子 类 型 一 样 ， 即 可 空 类 
型 和 非 空 类 型 。 同 时 ， 这 也 是 Nothing 被 称 作 空 类 型 的 原因 。 这 意味 着 ， 不 存在 任何 值 可 
在 运行 期 内 包含 该 类 型 ， 同 时 它 也 是 其 他 类 型 的 子 类 型 ， 如 图 3.2 所 示 。 
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FA 3.2 


对 于 Java ME, 空 类 型 则 是 一 个 全 新 的 概念 ,因而 读者 可 能 对 此 稍 感 陌生 。 实际 上 ， 
这 一 概念 十 分 简单 。 另 外 ， 无 法 生成 Nothing 实例 ， 且 仅 存 在 从 函数 返回 的 错误 信息 ， 
并 将 其 作为 返回 类 型 。 此 外 ， 对 于 Nothing 来 讲 ， 没 有 必要 添加 任何 内 容 以 对 该 类 型 产 
生 影 响 。 
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本 章 考 察 了 函数 的 定义 和 使 用 方式 ， 以 及 项 级 函数 和 其 他 函数 内 部 的 定义 方式 。 除 此 
之 外 ， 本 章 还 讨论 了 与 函数 关联 的 不 同 特征 ， 包 括 ararg 参数 、 默 认 名 称 以 及 命名 参数 语 
法 。 最 后 , 本 章 还 查看 了 Kotlin 特定 返回 类 型 , 包括 Unit( 等 价 于 Java 中 的 void) ffl Nothing 
(Nothing 是 一 种 无 法 定义 的 类 型 ， 表 示 为 空 类 型 且 仅 为 异常 )。 

第 4 章 将 探讨 Kotlin 中 类 的 定义 方式 。Kotlin 语言 对 类 给 予 了 特殊 的 支持 ， 并 在 Java 
定义 的 基础 上 引入 了 大 量 的 改进 措施 。 
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Kotlin 语言 对 OOP 程序 设计 提供 了 完整 的 支持 。 本 章 将 考察 这 一 强大 的 结构 ， 从 而 
简化 数据 模型 的 定义 ， 同 时 采用 一 种 简单 、 灵 活 的 方式 在 类 结构 上 进行 操作 。 此 外 ， 还 
将 介绍 诸多 概念 的 简化 和 改进 方式 ， 相 关 概 念 均 来 自 于 Java。 同 时 ， 本 章 还 将 探讨 不 同 
类 结构 的 类 型 、 属 性 、 初 始 化 程序 代码 块 以 及 构造 方法 ， 另 外 还 会 涉及 操作 符 重 载 和 接 
默认 实现 。 

本 章 主要 涉及 以 下 内 容 : 

e 类 声明 。 

e 属性。 

e 属性 的 访问 语法 。 

e 构造 方法 和 初始 化 程序 代码 块 。 

e 构造 方法 。 

e 继承 。 

eH. 
e 数据 类 。 

e 解构 声明 。 
e 操作 符 重 载 。 
e 对 象 声 明 。 
e 对 象 表 达 式 。 
e 伴生 对 象 。 
o KOBE. 

e 密封 类 。 
WREX. 
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类 是 OOP 中 的 基本 构造 模块 。 实 际 上 ，Kotlin 类 与 Java 类 十 分 类 似 。 然 而 ，Kotlin 
采用 更 为 简单 、 简 洁 的 语法 实现 了 更 加 丰富 的 功能 。 
Kotlin 中 的 类 采用 class 关键 字 加 以 定义 。 下 列 最 简单 的 类 声明 表示 名 为 Person 的 
空 类 。 
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class Person 


Person 声明 未 包含 任何 类 体 ， 但 仍 可 通过 默认 的 构造 方法 予以 初始 化 ， 如 下 所 示 : 


val person = Person() 


即使 类 初始 化 这 一 类 简单 的 任务 ， 在 Kotlin 中 也 得 到 了 简化 。 与 Java 不 同 ，Kotlin 并 不 需 
要 使 用 new 关键 字 生成 类 实例 。 鉴 于 Kotlin 与 Java 之 间 紧 密 的 关联 性 ， 可 采用 相同 方式 
实例 化 定义 于 Java 和 Kotlin PHX (HEHEH new 关键 字 )。 类 实例 化 语法 取决 于 生成 
类 实例 的 具体 语言 (Kotlin 或 Java)， 如 下 所 示 : 

// Instantiate Kotlin class inside Java file 

Person person = new Person() 


// Instantiate class inside Kotlin file 
var person - Person() 


作为 一 项 经 验 法 则 ， 可 在 Java 文件 中 使 用 new 关键 字 ; 而 在 Kotlin 文件 中 ， 则 无 须 使 月 
new 关键 字 。 
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属性 表示 为 幕后 字段 (backing field) 和 访问 器 的 组 合 结果 ， 即 包含 getter 和 setter 77 
法 的 幕后 字段 ， 或 者 是 包含 两 种 方法 之 一 的 幕后 字段 。 另外， 属性 可 作为 项 级 (直接 在 文 
件 中 ) 或 成 员 (位 于 类 、 接 口中 ) 加 以 定义 。 

通常 情况 下 ， 建 议 对 属性 加 以 定义 (包含 getter/setter 的 私有 字段 )， 而 非 直 接 访问 公 
有 字段 。 








Java 中 私有 字段 的 setter 和 getter 规则 
(1) getter 方法 : 表示 为 一 类 无 参数 方法 ， 包 含 一 个 对 应 于 属性 名 的 名 
@ 称 ， 以 及 一 个 get WA ( 对 于 Boolean 属性 ， 则 使 用 is 前 组 )。 
(2 ) setter 方法 : 表示 为 单一 参数 的 方法 ,包含 以 set 起 始 的 名 称 ， 例 如 
setResult ( String resultCode ). 


Kotlin 通过 语言 设计 确保 了 这 一 原则 ， 该 方案 提供 了 诸多 封装 优点 ， 如 下 所 示 : 
e 无 须 改变 外 部 API 即 可 调整 内 部 实现 。 

e 确保 不 变性 (调用 方法 以 验证 对 象 状 态 )。 

o 当 访 问 成 员 时 ， 可 执行 额外 操作 (例如 日 志 操 作 )。 

当 定 义 顶 级 属性 时 ， 可 简单 地 在 Kotlin 文件 中 对 其 进行 定义 ， 如 下 所 示 : 
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// Test.kt 

val name:String 

假设 需要 通过 一 个 类 存储 与 菜 人 相关 的 基本 数据 ， 该 数据 可 从 外 部 API RA Cain), 
或 者 从 本 地 数据 库 中 获取 。 当 前 类 应 定义 两 个 (成 员 ) 属性 ， 即 name 和 age。 下 面 首先 考 
察 Java 实现 ， 如 下 所 示 : 


public class Person ( 





private int age; 
private String name; 


public Person(String name, int age) ( 
this.name - name; 
this.age - age; 

) 


public int getAge() ( 
return age; 
) 


public void setAge(int age) ( 
this.age - age; 
) 


public String getName() ( 
return name; 
} 


public void setName(String name) { 
this.name = name; 

A } 
该 类 仅 包含 两 个 属性 。 由 于 Java IDE 可 帮助 我 们 生成 访问 器 代码 ， 因 而 无 须 采用 手动 方式 
编写 。 然 而 ， 该 方案 的 问题 是 ， 如 果 IDE 未 自动 生成 相应 的 代码 块 ， 相 关 工 作 将 无 法 进 一 
步 展 开 ， 另 外， 代码 也 变 得 相对 元 长 。 开 发 人 员 将 花费 大 量 的 时 间 阅 读 代码 ， 而 不 是 着 手 
编写 代码 。 阅 读 元 余 代码 将 会 浪费 大 量 的 时 间 。 另 外 ， 诸 如 重 构 属性 名 这 一 类 简单 任务 将 
变 得 更 富 技巧 性 一 一 IDE 可 能 并 不 会 更 新 构造 方法 参数 名 。 

然而 ，Kotlin 可 显著 地 降低 模板 代码 量 。 对 此 ，Kotlin 引入 了 内 建 于 该 语言 的 属性 概 
念 。 下 面 考察 前 述 Java 类 中 的 Kotlin 等 价 类 ， 如 下 所 示 : 
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class Person ( 
var name: String 
var age: Int 


constructor(name: String, age: Int) ( 
this.name = name 
this.age - age 


} 

上 述 代 码 表 示 为 之 前 Java 类 的 等 价 内 容 ， 其 中 : 

* constructor 方法 等 价 于 Java 的 构造 方法 。 当 生成 对 象 实例 时 ， 该 方法 将 被 调用 。 

o Kotlin 编译 器 负责 生成 getter 和 setter. 

当然 ， 可 自 定义 getter 和 setter 的 实现 内 容 ， 稍 后 将 对 此 加 以 详细 讨论 。 

之 前 全 部 已 定义 的 构造 函数 称 作 次 级 构造 函数 。Kotlin 还 提供 了 一 种 替代 方案 ， 并 采 
简洁 的 语法 定义 构造 函数 。 对 此 ， 可 将 构造 函数 (包含 全 部 参数 ) 定义 为 类 中 的 部 分 内 
容 , 此 类 构造 函数 称 作 主 构造 函数 。 下面 将 次 级 构造 函数 中 的 属性 声明 移 至 主 构造 函数 中 ， 
进而 适当 减少 代码 量 ， 如 下 所 示 ; 

class Person constructor(name: String, age: Int) ( 


var name: String 
var age: Int 














am 





























ama 4 
this.name = name 
this.age = age 
println("Person instance created") 


) 

与 次 级 构造 函数 不 同 ， 在 Kotlin 中 ， 主 构造 函数 不 可 包含 任何 代码 ， 因 此 ， 初 始 化 代 
码 须 置 于 初始 化 程序 代码 块 中 init)。 在 生成 类 时 ， 将 执行 初始 化 程序 代码 块 。 其 中 ， 可 
将 构造 函数 参数 赋予 其 中 的 字段 。 

为 了 简化 代码 ， 可 移 除 初始 化 程序 代码 块 ， 并 直接 访问 属性 初始 化 程序 中 的 构造 函数 
参数 。 这 可 将 构造 函数 参数 直接 赋予 某 个 字段 ， 如 下 所 示 : 


class Person constructor(name: String, age: Int) { 




















var name: String = name 
var age: Int — age 
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尽管 代码 量 有 所 减少 ， 但 仍然 涵盖 了 一 些 模板 代码 。 其 中 ， 类 型 声明 、 属 性 名 均 重 复 
出 现 〈 构 造 函 数 参数 、 字 段 复制 以 及 字段 自身 )。 若 属性 未 包含 自 定 义 的 getter 和 setter 方 
法 ， 则 可 直接 在 主 构造 函数 中 通过 添加 val 或 var 对 其 进行 定义 ， 如 下 所 示 : 


class Person constructor (var name: String, var age: Int) 


最 后 , 若 主 构造 函数 未 包含 任何 注解 (例如 @Inject 等 ), 或 者 可 见 性 修饰 符 ( 例 如 public, 
private 等 )， 则 可 忽略 constructor 关键 字 ， 如 下 所 示 : 

class Person (var name: String, var age: Int) 

当 构 造 函数 接收 某 些 参数 时 ， 一 种 较 好 的 做 法 是 ， 在 新 的 一 行 中 定义 各 个 参数 ， 进 而 
提升 代码 的 可 读 性 ， 同 时 减少 潜在 合并 冲突 的 概率 〈 合 并 源 代 码 存储 库 中 的 分 支 )， 如 下 
所 示 : 

class Person( 

var name: String, 
var age: Int 

) 

综 上 所 述 ， 在 当前 示例 中 ， 属 性 均 直 接 定义 于 类 主 构造 函数 中 ，Kotlin 编译 器 为 我 们 实现 
了 大 量 工作 ， 例 如 生成 相应 的 字段 和 访问 器 (getter/setter)。 

注意 ， 此 类 标注 法 仅 包 含 了 与 数据 模型 类 相关 的 、 最 为 重要 的 信息 ， 包 括 名 称 、 参 数 

名 、 类 型 以 及 可 变 (val/var) 信息 。 这 也 使 得 对 应 类 易于 阅读 、 理 解 和 维护 。 


4.2.1 读 - 写 属性 和 只 读 属性 


在 之 前 的 示例 中 ， 全 部 属性 均 以 读 - 写 方式 定义 〈setter 方法 和 getter 方法 )。 当 定义 只 
读 属性 时 ， 需 要 使 用 到 val 关键 字 ， 因 而 仅 生成 getter 方法 ， 如 下 所 示 : 


class Person( 
var name: String, 
// Read-write property (generated getter and setter) 
val age: Int // Read-only property (generated getter) 
) 























// usage 
val person - Person("Eva", 25) 


val name = person.name 
person.name = "Kate" 


val age - person.age 
person.age = 28 // error: read-only property 


第 4 章 类 和 对 象 “85 


Kotlin 并 不 支持 只 写 属性 〈 此 时 仅 会 生成 setter 方法 )。 表 4.1 显示 了 Kotlin 中 与 读 、 
写 相关 的 属性 。 














表 4.1 
关键 字 写 
var 是 
val E 
不 支持 是 





4.2.2 属性 访问 语法 


Kotlin 中 另 一 项 重大 改进 则 是 属性 的 访问 方式 。 在 Java 中 ， 可 通过 对 应 方法 访问 属性 
(例如 setSpeed/getSpeed)。Kotlin 则 提供 了 属性 访问 语法 ， 并 具有 鲜明 的 表达 方式 。 下 面 
对 两 种 方案 加 以 考察 ， 假 设 类 Car 中 包含 了 单一 speed 属性 ， 如 下 所 示 : 


class Car (var speed: Double) 





























// Java access properties using method access syntax 
Car car = new Car(7.4) 

car.setSpeed(9.2) 

Double speed = car.getSpeed():; 


// Kotlin access properties using property access syntax 
val car: Car - Car(7.4) 

car.speed - 9.2 

val speed - car.speed 


通过 观察 可 知 ， 在 Kotlin 中 ， 无 须 添加 get. set 和 括号 以 访问 或 修改 对 象 属性 。 属 性 访问 
语法 可 直接 使 用 ++ 和 -- 操 作 符 ， 并 与 属性 访问 协同 使 用 ， 如 下 所 示 : 


val car = Car(7.0) 
println(car.speed) // prints 7.0 
car.speed++ 

printin(car.speed) // prints 8.0 
Car.speed—— 

Car. speed—— 

println(car.speed) // prints: 6.0 


其 中 ， 存 在 两 种 递增 (++) 和 递减 〈 一 ) 操作 符 ， 即 前 递增 /前 递减 〈 操 作 符 在 表达 式 之 
前 定义 )， 以 及 后 递增 /后 递减 〈 操 作 符 在 表达 式 之 后 定义 )， 如 下 所 示 : 
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++speed //pre increment 
--speed //pre decrement 


speed++ //post increment 
Speed-- //post decrement 


前 递增 和 前 递减 操作 符 并 不 会 对 结果 产生 影响 ， 此 类 操作 符 仅 是 按 顺 序 执行 。 





当 与 函数 调用 结合 使 用 时 ， 情 况 则 有 所 变化 。 


但 是 ， 


在 前 递增 操作 符 中 ， 首 先 获得 speed 值 ， 递 增 后 作为 参数 传递 至 函数 中 ， 如 下 所 示 : 


var speed = 1.0 
Println(++speed) // Prints: 2.0 
println(speed) // Prints: 2.0 


在 后 递增 操作 符 中 ， 首 先 获得 speed 值 ， 作 为 参数 传递 至 函数 中 ， 随 后 递增 。 
原 值 将 传递 至 函数 中 ， 如 下 所 示 : 


var speed - 1.0 
println(speed-«) // Prints: 1.0 
println(speed) // Prints: 2.0 


qp 关于 前 递减 和 后 递减 操作 符 ， 其 工作 方式 也 大 致 类 似 。 


因此 ， 





需要 说 明 的 是 ， 属 性 访问 语法 不 仅 限 于 Kotlin 中 定义 的 类 。 各 种 方法 (针对 getter 和 





setter 方法 ， 遵 循 Java 规则 ) 均 可 表示 为 Kotlin 中 的 属性 。 


























因此 ,可 在 Java 中 定义 一 个 类 ， 并 采用 属性 访问 语法 访问 Kotlin 中 的 属性 。 下 面 定义 


一 个 Fish 类 ， 其 中 包含 两 个 属性 ， 即 size 和 isHungry。 随 后 在 Kotlin 中 初始 化 该 类 ， 并 访 





问 其 属性 ， 如 下 所 示 : 


// Java class declaration 
public class Fish { 
private int size; 
private boolean hungry; 
public Fish(int size, boolean isHungry) ( 
this.size = size; 
this.hungry - isHungry; 
} 


public int getSize() ( 
return size; 
} 


public void setSize(int size) { 
this.size = size; 
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} 


public boolean isHungry() { 
return hungry; 
) 


public void setHungry (boolean hungry) ( 
this.hungry - hungry; 
} 
} 


// Kotlin class usage 

val fish = Fish(12, true) 

fish.size = 7 

println(fish.size) // Prints: 7 
fish.isHungry = true 
println(fish.isHungry) // Prints: true 


上 述 代 码 可 通过 两 种 方式 工作 ， 因 而 可 利用 更 加 简洁 的 语法 在 Kotlin 中 定义 Fish 25, 
Kotlin 编译 器 将 生成 全 部 所 需 的 getter 和 setter， 如 下 所 示 : 


//Kotlin class declaration 
class Fish(var size: Int, var hungry: Boolean) 





//class usage in Java 

Fish fish - new Fish(12, true); 
fish.setSize(7); 
System.out.println(fish.getSize()); 
fish.setHungry (false); 
System.out.println(fish.getHungry()); 


实际 上 ， 用 于 访问 类 属性 的 语法 取决 于 类 使 用 的 实际 语言 ， 而 不 是 类 声明 中 的 语言 ， 
对 于 在 Android 框架 中 定义 的 类 ， 这 将 支持 大 量 的 惯用 操作 。 表 4.2 显示 了 相关 示例 。 


表 4.2 





Kotlin 属性 访问 语法 
activity.fragmentManager 
view.visibility = Visibility.GONE 
context.resources.displayMetrics.density 


Java 方法 访问 语法 
activity.getFragmentManager() 
view.setVisibility(Visibility. GONE) 
context.getResources().getDisplayMetrics().density 
属性 访问 语法 可 生成 更 为 简洁 的 代码 , 从 而 降低 原 Java 语言 的 复杂 度 。 需 要 注意 的 是 ， 

虽然 属性 访问 语法 可 视 作 一 种 较 好 的 蔡 代 方案 ， 但 Kotlin 中 依然 会 使 用 到 方法 访问 语法 。 
在 Android 框架 中 ， 一 些 方法 名 称 前 还 会 使 用 到 is HR: UCT, Boolean 属性 也 可 包 
含 is 前 级 ， 如 下 所 示 : 
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class MainActivity : AppCompatActivity() ( 


override fun onDestroy() ( // 1 
super.onDestroy () 


isFinishing() // method access syntax 
isFinishing // property access syntax 
finishing // error 
) 
) 
Kotlin 通过 override 修饰 符 标 记 重 载 成 员 ， 而 非 Java 中 的 @Override 标记 。 
虽然 使 用 finishing 是 一 种 自然 、 一 致 的 方案 , 但 默认 时 应 避免 使 用 以 防止 潜在 的 冲突 。 
另 一 个 不 可 使 用 属性 访问 语法 的 场合 是 : 属性 仅 定义 了 setter 且 未 定义 getter。Kotlin 
不 支持 只 写 属 性 ， 如 下 所 示 : 
fragment.setHasOptionsMenu (true) 
fragment.hasOptionsMenu - true // Error! 





























4.2.3 AEX getter/setter 





有 些 时 候 ， 需 要 对 属性 应 用 赋予 更 大 的 控制 权 。 当 使 用 属性 时 ， 可 能 需要 执行 其 他 辅 
助 操作 。 例 如 ， 在 赋予 某 个 字段 前 对 值 进 行 验证 、 操 作 的 日 志 记录 行为 ， 或 者 使 实例 处 于 
无 效 状 态 。 对 此 ， 可 制定 自 定义 setter 和 /或 getter。 下 面向 Fruit 类 中 加 入 ecoRating 属性 。 
大 多 数 时 候 ， 需 要 通过 如 下 方式 向 类 声明 中 添加 该 属性 : 

class Fruit(var weight: Double, 

val fresh: Boolean, 
val ecoRating: Int) 

当 确 定 自 定义 getter 和 setter 时 ， 需 要 在 类 体 中 定义 一 个 属性 ， 而 非 类 声明 中 。 具 体 
而 言 ， 可 将 ecoRating 属性 移 至 类 体 中 ， 如 下 所 示 : 

class Fruit(var weight: Double, val fresh: Boolean, ecoRating: Int) 

ü 





var ecoRating: Int = ecoRating 
H 


当 在 类 体 中 定义 属性 时 , 须 利用 相关 值 对 其 进行 初始 化 (甚至 空 类 型 数据 也 需要 通过 null 
值 进 行 初始 化 )。 对 此 ， 可 提供 默认 值 ， 而 非 使 用 构造 函数 参数 填充 某 个 属性 ， 如 下 所 示 : 


class Fruit (Var weight: Double, val fresh: Boolean) { 
var ecoRating: Int = 3 





} 
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另外 ， 还 可 根据 其 他 属性 计算 默认 值 ， 如 下 所 示 : 


class Apple(var weight: Double, val fresh: Boolean) ( 
var ecoRating: Int when(weight) { 


1n 0.5.2.0 -> 5 
jin 0.4..0.5.—» 4 
in'^0.3..0.4 — 3 
2n50:2:50:73 5272 
else -> 1 


} 
针对 不 同 的 weight 构造 函数 参数 ， 将 设置 不 同 的 数值 。 
当 属 性 在 类 体 中 定义 时 ， 可 忽略 类 型 声明 一 一 对 应 类 型 可 从 当前 上 下 文中 进行 推断 ， 
如 下 所 示 : 


class Fruit(var weight: Double) { 
var ecoRating - 3 





) 
下 面 利用 默认 行为 〈 等 价 于 之 前 的 属性 ) 设置 自 定义 getter 和 setter， 如 下 所 示 : 


class Fruit(var weight: Double) ( 

var ecoRating: Int - 3 

get() ( 
println("getter value retrieved") 
return field 

} 

set(value) { 
field = if (value < 0) 0 else value 
println("setter new value assigned $field") 


) 


// Usage 

val fruit = Fruit(12.0) 

val ecoRating - fruit.ecoRating 

// Prints: getter value retrieved 
fruit.ecoRating = 3; 

// Prints: setter new value assigned 3 
fruit.ecoRating = -5; 

// Prints: setter new value assigned 0 














在 get 和 set 代码 块 中 ， 可 以 访问 一 个 特定 的 变量 field， 该 变量 对 应 于 属性 的 幕后 字 
段 (backing field)。 注 意 ，Kotlin 属性 声明 位 置 靠近 自 定义 的 getter/setter。 这 与 Java 明显 
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不 同 ， 并 解决 了 如 下 问题 : 字段 声明 一 般 位 于 类 文件 的 顶部 ， 且 对 应 的 getter/setter 处 于 文 
件 的 底部 。 
因而 无 法 在 单一 屏幕 内 对 其 进行 查看 ， 进 而 导致 代码 难以 阅读 。 除 了 位 置 问题 之 外 ， 
Kotlin 属性 与 Java 十 分 类 似 。 每 次 从 ecoRating 属性 中 获取 值 时 ， 均 需要 执行 get 代码 块 ; 
而 每 次 将 新 值 赋予 ecoRating 属性 时 ， 则 需要 执行 set 代码 块 。 
作为 只 读 属 性 (var), WEAS getter/setter。 此 时 ， 应 显 式 地 定义 其 中 的 一 个 方法 ， 并 
将 另 一 个 用 于 默认 实现 。 
当 每 次 获取 属性 值 并 进行 计算 时 ， 需 要 显 式 地 定义 getter， 如 下 所 示 : 
class Fruit(var weight: Double) { 
val heavy // 1 
get() = weight > 20 
H 























ca 




















// usage 

var fruit - Fruit(7.0) 
println(fruit.heavy) //prints: false 
fruit.weight - 30.5 
println(fruit.heavy) //prints: true 


H Kotlin 1.1 起 ， 类 型 将 被 省 略 〈 采 用 推断 方式 )。 

前 述 示例 使 用 了 getter， 因 而 每 次 取 值 时 将 计算 属性 值 。 通 过 忽略 getter 这 一 方式 ， 可 
针对 属性 生成 默认 值 。 在 类 构建 过 程 中 ， 该 值 仅 计算 一 次 ， 且 不 会 产生 变化 修改 weight 
属性 对 isHeavy 属性 值 不 会 产生 任何 影响 )， 如 下 所 示 : 


class Fruit(var weight: Double) ( 
val isHeavy - weight » 20 











) 

var fruit = Fruit(7.0) 
println(fruit.isHeavy) // Prints: false 
fruit.weight - 30.5 
println(fruit.isHeavy) // Prints: false 


该 属性 类 型 包含 了 幕后 字段 ， 其 值 通常 是 在 对 象 生成 过 程 中 被 计算 。 另 外 ， 还 可 创建 不 包 
含 幕后 字段 的 读 - 写 属性 ， 如 下 所 示 : 
class Car { 


var usable: Boolean = true 
var inGoodState: Boolean - true 





var crashed: Boolean 
get() = !usable && !inGoodState 
set(value) ( 
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E ce" 
} 
此 处 ， 属 性 类 型 不 包含 幕后 字段 ， 其 值 通常 使 用 另 一 个 属性 计算 。 
4.2.4 延迟 初始 化 属性 


某 些 时 候 ， 已 知 属性 不 应 为 null， 但 并 不 会 在 声明 阶段 利用 相应 值 进行 初始 化 。 下 面 
考察 一 个 Android 常见 示例 ， 即 获取 指向 布局 元 素 的 引用 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() ( 











private var button: Button? = null 


override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate (savedInstanceState) 
button = findViewById(R.id.button) as Button 
} 
} 


HP, button 在 声明 阶段 无 法 初始 化 ， 因 为 MainActivity 布局 尚未 被 初始 化 。 对 此 ， 可 获 
取 指 向 button 的 引用 (定义 于 布局 内 ， 并 位 于 onCreate 方法 中 )， 但 需要 将 变量 声明 为 可 
空 类 型 (Button?)。 
此 类 方案 缺乏 实际 操作 意义 一 一 在 onCreate 方法 被 调用 后 ，button 实例 将 一 直 处 于 有 
效 状 态 。 然而, 客户 端 仍 需 要 使 用 安全 调用 操作 符 , 或 者 其 他 空 检查 操作 以 对 其 进行 访问 。 
为 了 在 访问 属性 时 避免 执行 空 检查 ， 需 要 一 种 方式 告知 Kotlin 编译 器 ， 对 应 变量 已 
在 使 用 前 被 赋值 ， 但 其 初始 化 操作 将 被 延迟 。 对 此 ， 可 使 用 lateinit 修饰 符 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() ( 

















private lateinit var button: Button 


override fun onCreate(savedInstanceState: Bundle?) ( 
button = findViewById(R.id.button) as Button 
button.text = "Click Me" 
} 
} 


利用 标记 为 lateinit 的 属性 时 ， 无 须 执行 空 检查 即 可 访问 应 用 程序 实例 。 
lateinit 修饰 符 告知 编译 器 , 对 应 属性 为 非 空 类 型 , 但 其 初始 化 操作 将 被 延迟 。 自 然 地， 
若 尝 试 在 初始 化 之 前 访问 属性 ， 应 用 程序 将 会 抛 出 UninitializedPropertyAccess Exception. 
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变量 在 声明 阶段 无 法 初始 化 是 一 类 较 





为 常见 的 情况 ， 通 常 与 视图 无 关 。 属 性 可 通过 





Dependency Injection 进行 初始 化 ， 或 者 通过 单元 测试 的 setup 方法 。 在 此 类 方案 中 ， 无 法 
在 构造 函数 中 提供 非 空 值 ， 但 仍 须 避 免 空 检查 操作 。 
延迟 属性 和 框架 
当 属 性 通过 Dependency Injection 框架 置 入 时 ,lateinit 属性 十 分 有 用 。 作 
为 一 种 较为 流行 的 Android Dependency Injection 框架 , Dagger 使 用 了 @Inject 


注解 对 需要 置 入 的 属性 予以 标记 





， 如 下 所 示 : 


@Inject lateinit var locationManager: LocationManager 
qp 如 前 所 述 ， 属 性 不 可 为 null ( 将 被 置 入 )， 但 Kotlin 编译 器 并 不 理解 这 一 


注解 


类 似 的 情形 也 会 出 现 于 另 一 个 常见 框架 中 ， 即 Mockito， 如 下 所 示 : 


@Mock lateinit var mockEventBus: EventBus 


该 变量 将 被 模拟 ， 但 会 在 测试 类 创建 之 后 的 某 个 时 刻 发 生 。 


4.2.5 ”注解 属性 


Kotlin 从 单一 属性 中 可 生成 多 个 JVM 字 节 码 元 素 (private 字段 、getter 以 及 setter). 
某 些 时 候 ， 框 架 注 解 处 理 器 或 反射 库 需 要 使 用 特定 元 素 ， 并 定义 为 公有 字段 ， 例 如 JUnit 
测试 框架 。 当 定义 ActivityTestRule， 或 Mockito (单元 测试 的 模拟 框架 的 Rule 注解 时 ， 














还 会 再 次 面临 这 一 问题 ， 如 下 所 示 : 


@Rule 








val activityRule = ActivityTestRule (MainActivity::class.Java) 


上 述 代 码 对 JUnit 未 予 识别 的 Kotlin 属性 进行 注解 ， 因 此 ，ActivityTestRule 无 法 实现 正常 


的 初始 化 操作 。JUnit 注解 处 理 器 期 望 获得 


方式 可 处 理 此 类 问题 。 例 如 ， 可 作为 Java 字段 展示 Kotlin 属性 ， 即 利用 @JvmField 对 其 


行 注解 ， 如 下 所 示 : 


GJvmField GRule 





字段 或 getter 上 的 Rule 注解 。 这 里 ， 存 在 多 种 
进 

















val activityRule = ActivityTestRule (MainActivity::class.Java) 





该 字段 与 底层 属性 具有 相同 的 可 见 性 。 关 了 








F@JvmField 注解 的 使 用 ， 存 在 某 些 限制 条 件 ， 





如 果 属 性 包含 幕后 字段 且 为 非 私有 属性 ， 不 包含 open. override BK const 修饰 符 ， 也 不 是 





一 个 委托 属性 ， 则 可 利用 @JvmField 对 其 力 








0 以 注解 。 
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另外 ， 还 可 直接 向 getter 添加 注解 ， 如 下 所 示 : 


val activityRule 
@Rule get() = ActivityTestRule (MainActivity::class.java) 


如 果 不 需 要 定义 getter， 仍 可 向 getter 添加 注解 。 据 此 ， 可 简单 地 确定 Kotlin 编译 器 生 





成 的 哪 一 类 元 素 可 被 注解 ， 如 下 所 示 : 


调 


Gget:Rule 
val activityRule - ActivityTestRule (MainActivity::class.Java) 


4.2.6 ”内 联 属 性 
通过 内 联 修饰 符 ， 可 优化 属性 调用 。 在 编译 期 间 ， 各 个 属性 将 被 优化 。 此 处 并 未 真正 














日 某 个 属性 ， 调 用 将 被 属性 体 所 替换 ， 如 下 所 示 : 





inline val now: Long 
get() ( 
println("Time retrieved") 
return System.currentTimeMillis() 


) 
关于 内 联 属性 ， 可 采用 inline 修饰 符 。 随 后 ， 上 述 代 码 将 编译 为 : 


println("Time retrieved") 
System.currentTimeMillis() 


由 于 无 须 创建 附加 对 象 ， 因 而 内 联机 制 可 对 性 能 予以 改善 。 另 外 ， 方 法 体 将 被 属性 应 











HER KETAWA getter。 但 是 ， 内 联机 制 也 包含 了 自身 的 局 限 性 一 一 只 能 应 用 于 不 
包含 幕后 字段 的 属性 上 。 


Kotlin 可 定义 不 包含 构造 函数 的 类 。 除 此 之 外 ， 还 可 定义 一 个 主 构造 函数 ， 以 及 一 个 





或 多 个 次 级 构造 函数 ， 如 下 所 示 : 


class Fruit(val weight: Int) { 
constructor(weight: Int, fresh: Boolean) : this(weight) { } 


} 


// class instantiation 
val fruiti = Fruit(10) 
val fruit2 = Fruit(10, true) 
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次 级 构造 函数 不 支持 属性 声明 。 如果 需 要 使 用 到 一 个 属性 , 并 由 次 级 构造 函数 初始 化 ， 
需要 在 类 体 中 对 其 加 以 声明 ， 并 在 次 级 构造 函数 体 中 对 其 进行 初始 化 。 下 列 代码 定义 了 
fresh: 























class Test(val weight: Int) { 
var fresh: Boolean? = null 
// define fresh property in class body 


constructor(weight: Int, fresh: Boolean) : this(weight) ( 
this.fresh = fresh 
// assign constructor parameter to fresh property 


} 
需要 注意 的 是 ，fresh 属性 定义 为 可 空 类 型 一 一 当 采 用 主 构造 函数 生成 对 象 实例 时 ， 
fresh 属性 为 null， 如 下 所 示 : 


val fruit = Fruit(10) 
println(fruit.weight) // prints: 10 
println(fruit.fresh) // prints: null 


另外 ， 还 可 将 默认 值 赋予 fresh 属性 中 ， 并 使 其 非 空 ， 如 下 所 示 : 


class Fruit(val weight: Int) ( 
var fresh: Boolean - true 











constructor(weight: Int, fresh: Boolean) : this(weight) ( 
this.fresh - fresh 
) 
) 


val fruit - Fruit(10) 
println(fruit.weight) // prints: 10 
println(fruit.fresh) // prints: true 


在 定义 主 构造 函数 时 ， 各 个 次 级 构造 函数 须 隐 式 或 显 式 地 调用 主 构造 函数 。 其 中 ， 隐 
式 调 用 意味 着 ， 直 接 调 用 主 构造 函数 ， 显 式 调用 则 表明 ， 调 用 另 一 个 次 级 构造 函数 ， 且 该 
构造 函数 调用 主 构造 函数 。 当 调用 另 一 个 构造 函数 时 ， 可 使 用 this 关键 字 ， 如 下 所 示 : 


class Fruit(val weight: Int) ( 






































X 


constructor(weight: Int, fresh: Boolean) : this(weight) // 1 


constructor(weight: Int, fresh: Boolean, color: String) 
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this(weight, fresh) // 2 
l 
。 在 注释 1 中 ， 调 用 主 构造 函数 。 
e 在 注释 2 中 ， 调 用 次 级 构造 函数 。 
如 果 类 未 包含 主 构造 函数 ， 且 超 类 包含 了 一 个 非 空 的 构造 函数 ， 那 么 ， 次 级 构造 函数 
须 通过 super 关键 字 初 始 化 基 类 ， 或 者 调用 执行 此 项 工作 的 另 一 个 构造 函数 ， 如 下 所 示 : 
class ProductView : View { 
constructor(ctx: Context) : super(ctx) 
constructor(ctx: Context, attrs : AttributeSet) : 
super(ctx, attrs) 
5 
通过 @JvmOverloads 注解 ， 上 述 示例 得 到 了 极 大 的 简化 。 
默认 状态 下 ， 所 生成 的 构造 函数 应 为 公有 类 型 。 若 不 希望 生成 此 类 隐 式 public 构造 函 
数 ， 可 使 用 private EÈ protected 可 见 性 修饰 符 ， 并 声明 一 个 空 的 主 构造 函数 ， 如 下 所 示 ; 


class Fruit private constructor() 

当 改 变 构造 函数 的 可 见 性 时 ， 须 在 类 定义 中 显 式 地 使 用 constructor 构造 函数 。 另 外 ， 
当 打算 注解 某 个 构造 函数 时 , 也 需要 使 用 到 constructor 关 键 字 。 一 个 常见 示例 是 采用 Dagger 
(Dependency Injection 框架 ) 的 @Inject 注解 类 构造 函数 ， 如 下 所 示 ; 

class Fruit @Inject constructor () 
另外 ， 可 见 性 修饰 符 和 注解 还 可 同时 使 用 ， 如 下 所 示 : 


class Fruit @Inject private constructor { 
var weight: Int? = null 





} 


4.3.1 属性 和 构造 函数 参数 

需要 注意 的 是 , 如 果 从 构造 函数 属性 声明 中 移 除 var/val 关键 字 , 则 需要 以 构造 函数 参 
数 声 明 结束 。 这 也 表明 ， 属 性 将 被 修改 为 构造 函数 参数 ， 因 此 不 会 生成 访问 器 ， 且 无 法 在 
类 实例 中 访问 属性 ， 如 下 所 示 : 


class Fruit (Var weight:Double, fresh:Boolean) 





val fruit = Fruit(12.0, true) 
println(fruit.weight) 
println(fruit.fresh) // error 
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在 上 述 示例 中 ， 由 于 fresh 缺少 val 或 var 关键 字 ， 因 而 将 会 产生 错误 一 一 此 处 为 构造 函数 
参数 ， 而 非 类 属性 〈 例 如 weight). X 4.3 总 结 了 编译 器 访问 器 的 生成 状况 。 









































表 4.3 
类 声明 是 否 生 成 getter 是 否 生 成 setter 类 型 
class Dunt z s 构造 函数 参数 
(name:String) 
class Fruit - 
(val name:String) 属性 
class Fruit 属性 


Cvar name:String) 





读者 可 能 会 感到 疑惑 : 何 时 应 使 用 属性 , 而 何 时 又 应 使 用 方法 ? 作为 一 个 较 好 的 准则 ， 
建议 在 下 列 情况 中 使 用 属性 而 非 方法 ): 

o 未 抛 出 异常 。 

e 较 小 的 计算 代价 或 者 首次 运行 时 实现 了 缓存 )。 

e 多 次 调用 返回 相同 的 结果 。 


432 ”包含 默认 参数 的 构造 函数 


Java 在 早期 时 候 针 对 对 象 生成 问题 存在 一 系列 的 缺陷 。 当 对 象 需要 多 个 参数 ， 且 部 分 
参数 可 选 时 ， 通 常 难以 创建 一 个 对 象 。 针 对 这 一 问题 ， 存 在 多 种 方式 可 对 其 加 以 解决 。 例 
如 ，Telescoping 构造 器 模式 、JavaBeans 模式 以 及 Builder 模式 ， 各 种 模式 均 包 含 自身 的 优 

模式 用 于 解决 对 象 生成 问题 ， 具 体 解 释 如 下 。 

e Telescoping 构造 器 模式 : 包含 构造 器 列表 的 类 。 其 中 , 每 个 构造 器 添加 一 个 新 参数 。 

当前 ，Telescoping 构造 器 模式 视 为 一 种 反 模式 ， 但 Android 框架 仍 在 多 处 使 用 到 该 
模式 ， 例 如 android.view.View 类 ， 如 下 所 示 : 


val viewl = View(context) 

val viewl = View(context, attributeSet) 

val viewl = View(context, attributeSet, defStyleAttr) 

e JavaBeans 模式 : 无 参 构 造 器 以 及 一 个 或 多 个 setter 方法 配置 对 象 。 该 模式 的 主要 问 
题 是 ， 无 法 知晓 全 部 所 需 对 象 是 否 在 一 个 对 象 上 被 调用 ， 或 许 仅 可 实现 部 分 构造 ， 
如 下 所 示 : 
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val animal = Animal() 
fruit.setWeight (10) 
fruit.setSpeed(7.4) 
fruit.setColor ("Gray") 


* Builder 模式 : 使 用 另 一 个 对 象 ， 即 构造 器 ， 逐 一 接收 初始 化 参数 ;， 随后 ， 当 构造 方 
法 被 调用 时 ， 一 次 性 地 返回 结果 构造 对 象 。 例 如 : 


android.app.Notification.Builder, or 
android.app.AlertDialog.Builder: 


























Retrofit retrofit = new Retrofit.Builder() 
-baseUrl ("https://api.github.com/") 
-build(); 
长 期 以 来 ， 构 造 器 应 用 较为 广泛 ， 但 默认 参数 和 命名 参数 语法 则 是 一 种 更 为 简洁 的 方 
下 面 定义 某 些 默认 值 ， 如 下 所 示 : 
class Fruit(weight: Int = 0, fresh: Boolean = true, color: 
String - "Green") 


通过 定义 默认 参数 值 ， 可 采用 多 种 方式 创建 对 象 ， 且 无 须 传递 全 部 参数 ， 如 下 所 示 : 


val fruit = Fruit(7.4, false) 
println(fruit.fresh) // prints: false 





























val fruit2 - Fruit(7.4) 
println(fruit.fresh) // prints: true 


当 生 成 对 象 时 ， 使 用 包含 默认 参数 的 参数 语法 具有 更 大 的 灵活 性 : 可 采用 任何 顺序 传 

















递 所 需 参数 ， 且 无 须 定义 多 个 方法 和 构造 函数 ， 如 下 所 示 : 





val fruitl = Fruit (weight = 7.4, fresh = true, color = "Yellow") 
val fruit2 = Fruit (color = "Yellow") 
44 继 7k 


如 前 所 述 ，Any 定义 为 全 部 Kotlin 类 型 的 超 类 型 ， 即 等 价 于 Java 中 的 Object 类 型 。 





每 个 Kotlin 类 均 显 式 或 隐 式 地 扩展 Any 类 。 如 果 不 需要 确定 父 类 ， 则 Any 隐 式 地 设置 为 


该 类 的 父 类 ， 如 下 所 示 : 


class Plant // Implicitly extends Any 
class Plant : Any // Explicitly extends Any 
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类 似 于 Java, Kotlin 支持 单 继 承 ， 因 此 一 个 类 只 能 包含 一 个 父 类 , 但 可 实现 多 个 接口 。 

相 比 于 Java, Kotlin 中 的 类 和 方法 , 默认 状态 下 均 为 fmal， 以 防止 子 类 对 其 进行 算 改 。 
基 类 的 修改 往往 会 导致 子 类 中 的 错误 行为 ， 其 原因 在 于 ， 基 类 修改 后 的 代码 将 不 再 与 其 子 
类 设置 相 匹配 。 

这 也 意味 着 ， 类 无 法 被 扩展 ;同时 ， 方 法 也 不 可 覆 写 ， 除 非 显 式 地 利用 open 关键 字 
对 其 加 以 声明 。 这 一 点 与 Java 的 final 关键 字 完全 不 同 。 

下 列 代码 声明 了 一 个 基 类 Plant 和 一 个 子 类 Tree. 


class Plant 
class Tree : Plant() // Error 


上 述 代码 尚 无 法 编译 一 一 默认 状态 下 ，Plant 类 处 于 final 状态 。 下 面 对 其 进行 修改 ， 以 使 
该 类 处 于 open 状态 ， 如 下 所 示 : 


open class Plant 
class Tree : Plant() 


注意 ， 在 Kotlin 中 使 用 冒号 即 可 简单 地 定义 继承 ， 且 不 必 添 加 Java 中 的 extends 或 
implements 关键 字 。 
下 面向 Plant 类 中 添加 相关 方法 和 属性 , 并 尝试 在 Tree 类 中 对 其 进行 覆 写 , 如 下 所 示 : 
open class Plant { 
var height: Int = 0 


fun grow(height: Int) {} 
) 













































































class Tree : Plant() ( 
override fun grow(height: Int) ( // Error 
this.height += height 
} 
} 


上 述 代 码 同 样 无 法 编译 。 默 认 条 件 下 ， 全 部 方法 均 处 于 封闭 状态 ， 因 而 所 需 覆 写 的 各 个 方 
法 须 显 式 地 标记 为 open。 下 列 代 码 将 grow 方法 标记 为 open， 进 而 对 原 代 码 进行 修复 。 
open class Plant { 
var height: Int = 0 


open fun grow(height: Int) {} 
) 





class Tree : Plant() ( 
override fun grow(height: Int) ( 
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this.height += height 
} 


采用 类 似 的 方式 ， 还 可 将 height 属性 设置 为 open 状态 ， 并 对 其 进行 覆 写 ， 如 下 所 示 : 


open class Plant ( 
open var height: Int - 0 
open fun grow(height: Int) () 




















H 
class Tree : Plant() ( 
override var height: Int - super.height 
get() = super.height 
set(value) ( field - value) 
override fun grow(height: Int) ( 
this.height += height 
) 


当 快速 对 成 员 进 行 覆 写 时 ， 可 选取 成 员 所 属 的 类 ,添加 open 修饰 符 ， 并 
& 访问 需要 履 写 成 员 的 对 应 类 ， 运 行 override 成 员 ( 在 Windows 环境 下 ， 快 捷 
键 为 CtrlHO; 在 macOS 环境 下 ， 快 捷 键 为 Command+O )， 并 选择 需要 履 写 
的 全 部 成 员 。 通 过 这 一 方式 ，Android Studio 可 生成 全 部 所 需 代 码 
假设 全 部 树木 均 以 相同 的 方式 生长 〈 即 针对 所 有 树木 ， 使 用 相同 的 生长 算法 )。 对 此 ， 
应 可 创建 Tree 类 的 子 类 ， 以 对 其 包含 更 多 控制 ， 同 时 还 可 保留 生长 算法 一 一 不 允许 Tree 的 
任何 子 类 覆 写 该 行为 。 对 此 ， 需 要 显 式 地 将 Tree 类 中 的 grow 方法 标记 为 final， 如 下 所 示 : 


open class Plant ( 
var height: Int = 0 











open fun grow(height: Int) () 
} 


class Tree : Plant() { 
final override fun grow(height: Int) ( 
this.height += height 
} 
} 


class Oak : Tree() { 
ASH 
H 
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wg 





F grow 方法 处 于 final 状态 ， 当 前 尚 无 法 对 其 进行 编译 。 
关于 open 和 final 的 行为 ， 当 设置 子 类 中 的 覆 写 方法 时 ， 须 在 超 类 中 将 其 显 式 地 标记 




















为 open。 为 了 确保 覆 写 方法 不 会 被 子 类 再 次 覆 写 ， 须 将 其 标记 为 final. 








在 当前 示例 中 ，Plant 类 中 的 grow 方法 未 提供 任何 功能 项 ( 仅 为 空 类 体 )， 因 而 无 须 实 











例 化 Plant 类 ， 且 仅 视 作 一 个 基 类 。 另 外 ， 可 实例 化 扩展 了 Plant 类 的 Tree 类 。 因 此 ， 应 
将 Plant 类 标记 为 abstract， 以 防止 其 实例 化 ， 如 下 所 示 : 








abstract class Plant { 
var height: Int = 0 


abstract fun grow(height: Int) 
) 


class Tree : Plant() ( 
override fun grow(height: Int) ( 
this.height += height 
} 
} 


val plant = Plant() 
// error: abstract class can't be instantiated 
val tree - Tree() 


默认 条 件 下 ，abstract 标记 使 得 方法 类 处 于 open 状态 ， 因 而 无 须 将 各 个 成 员 显 式 地 标 


记 为 open。 需 要 注意 的 是 ， 当 grow 方法 定义 为 abstract 时 ， 须 移 除 方法 体 ，abstract 方法 


不 会 包含 任何 方法 体 。 








Android 平台 中 的 某 些 类 使 用 Telescoping 构造 器 ， 这 可 视 为 一 种 反 模 式 ， 例 如 











android.view.View 类 。 此 类 情况 发 生 于 使 用 单一 构造 函数 时 。 但 对 android.view.View 子 类 
进行 子 类 化 时 ， 可 安全 地 重 载 3 个 构造 函数 ， 其 原因 在 于 ， 该 类 可 在 全 部 场合 下 正确 地 工 
作 。 通 常 ， 自 定义 View 类 如 下 所 示 : 








class CustomView : View ( 
constructor(context: Context?) : this(context, null) 
constructor(context: Context?, attrs: AttributeSet?) : 
this(context, attrs, 0) 


constructor(context: Context?, attrs: AttributeSet?, defStyleAttr: 
Int) : super(context, attrs, defStyleAttr) ( 
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EET 
) 


代码 中 针对 构造 函数 引入 了 大 量 的 样板 代码 , 并 托管 其 他 构造 函数 的 调用 。 针对 此 类 问题 ， 
Kotlin 的 方案 是 使 用 @JvmOverload 注解 ， 如 下 所 示 : 























class KotlinView @JvmOverloads constructor( 
context: Context, 
attrs: AttributeSet? = null, 
defStyleAttr: Int = 0 

) : View(context, attrs, defStyleAttr) 

















利用 @JvmOverload 注解 构造 函数 将 通知 编译 器 ， 针 对 包含 默认 值 的 各 个 参数 ， 将 在 JVM 
字 节 码 中 生成 额外 的 重 载 构造 函数 。 此 时 ， 将 生成 全 部 所 需 的 构造 函数 ， 如 下 所 示 ; 


public SampleView(Context context) ( 
super (context) ; 








} 


public SampleView(Context context, @Nullable AttributeSet attrs) { 
super(context, attrs); 
} 


public SampleView(Context context, @Nullable AttributeSet attrs, int 
defStyleAttr) { 


super(context, attrs, defStyleAttr); 
) 


45 接 口 























Kotlin 接口 类 似 于 Java 8 中 的 接口 ， 并 与 之 前 的 Java 版 本 形成 了 鲜明 的 对 比 。 接 口 通 
过 interface 关键 字 定 义 。 下 列 代码 定义 了 EmailProvider 接口 。 


interface EmailProvider { 
fun validateEmail () 




















} 
当 在 Kotlin 中 实现 该 接口 时 ， 可 使 用 与 扩展 类 相同 的 语法 ， 即 冒号 ， 且 不 存在 Java 中 的 
implements 关键 字 ， 如 下 所 示 : 


class User:EmailProvider { 
override fun validateEmail() ( 
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// email validation 
} 


这 里 的 问题 是 , 如 何 同时 扩展 类 并 实现 一 个 接口 ? 对 此 , 可 简单 地 将 类 名 置 于 冒号 后 
并 使 用 逗号 添加 一 个 或 多 个 接口 。 此 处 ， 无 须 在 起 始 位 置 放置 超 类 ， 虽 然 这 可 视 为 一 种 良 
好 的 习惯 。 


open class Person ( 























interface EmailProvider { 
fun validateEmail () 
) 
class User: Person(), EmailProvider ( 
override fun validateEmail () { 
// email validation 
) 
) 


类 似 于 Java, Kotlin 类 仅 可 扩展 一 个 类 ， 但 却 可 实现 一 个 或 多 个 接口 。 除 此 之 外 ， 还 
可 在 接口 中 声明 属性 ， 如 下 所 示 : 
interface EmailProvider { 


val email: String 
fun validateEmail () 














} 
全 部 方法 和 属性 须 在 实现 了 接口 的 类 中 重 载 ， 如 下 所 示 : 


class User() : EmailProvider ( 
override val email: String - "UserEmailProvider" 


override fun validateEmail() ( 
// email validation 
) 
) 


另外 ， 定 义 于 主 构造 函数 中 的 属性 可 用 于 重 载 接口 中 的 参数 ， 如 下 所 示 : 


class User (override val email: String) : EmailProvider { 
override fun validateEmail() ( 
// email validation 

















) 
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在 接口 中 ， 未 包含 默认 实现 的 全 部 方法 和 属性 ， 默 认 条 件 下 均 视 为 抽象 ， 因 而 无 须 显 
式 地 将 其 定义 为 abstract。 全 部 抽象 方法 和 属性 须 通过 实现 了 接口 的 实体 类 ( 非 抽象 类 ) T 
以 实现 。 
然而 ， 还 存在 另 一 种 方法 可 在 接口 中 定义 方法 和 属性 。Kotlin 与 Java 8 十 分 相似 ， 并 
对 接口 予以 重大 改进 。 接 口 不 仅 可 以 定义 行为 ， 还 可 予以 实现 。 这 意味 着 ， 属 性 实现 的 默 
认 方 法 可 通过 接口 提供 。 此 处 唯一 的 限制 条 件 是 ， 接 口 无 法 引用 任何 幕后 字段 ， 即 存储 某 
个 状态 〈 因 为 没有 合适 的 地 方 对 其 加 以 存储 )。 这 也 是 接口 和 抽象 类 之 间 的 不 同 之 处 。 接 
口 不 包含 任何 状态 (不 具备 某 个 状态 ); 而 抽象 类 则 包含 一 个 状态 。 如 下 所 示 : 


interface EmailProvider ( 





































































































fun validateEmail(): Boolean 
val email: String 


val nickname: String 
get() = email.substringBefore ("Q") 
) 
class User(override val email: String) : EmailProvider ( 
override fun validateEmail() ( 
// email validation 
) 
) 


对 于 nickname 属性 ，EmailProvider 接口 提供 了 默认 实现 ， 因 而 无 须 在 User 类 中 对 其 加 以 
定义 ， 且 仍 可 将 当前 属性 用 作 定 义 于 类 中 的 其 他 属性 ， 如 下 所 示 ; 


val user = User (" johnny.bravoetest.com") 
print(user.nickname) // prints: johnny 


同样 的 规则 也 适用 于 方法 。 可 简单 地 在 接口 中 定义 包含 方法 体 的 某 个 方法 。 因 此 , User 
类 从 接口 中 获取 全 部 默认 实现 ， 且 仅 须 覆 写 email 成 员 一 一 接口 中 唯一 不 包含 默认 实现 的 
成 员 。 如 下 所 示 : 


interface EmailProvider { 


























val email: String 


val nickname: String 
get() = email.substringBefore ("Q") 
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fun validateEmail() = nickname.isNotEmpty () 
} 


class User(override val email: String) : EmailProvider 


// usage 

val user = User("joeyétest.com") 
print(user.validateEmail()) // Prints: true 
print(user.nickname) // Prints: joey 


关于 默认 实现 ， 有 一 点 须 引 起 注意 。 一 个 类 无 法 继承 自 多 个 类 ， 但 可 实现 多 个 接口 。 
例如 ， 可 定义 两 个 接口 ， 并 包含 相同 签名 和 默认 实现 的 方法 ， 如 下 所 示 : 

















interface A ( 
fun foo() ( 
println ("A") 
) 
) 


interface B ( 
fun foo() { 
println ("B") 
} 
} 


在 上 述 类 中 ， 通 过 和 覆 写 (实现 了 接口 的 ) 类 中 的 foo 方法 ， 即 可 显 式 地 解决 冲突 问题 ， 如 


下 所 








class Item : A, B ( 
override fun foo() ( 
println ("Item") 
} 
} 


// usage 
val item = Item() 
item.foo() // prints: Item 


使 用 尖 角 括号 并 确定 父 接口 类 型 名 称 ， 仍 然 可 以 通过 限定 的 super 来 调用 两 个 默认 的 
接口 实现 ， 如 下 所 示 : 


class Item : A, B ( 
override fun foo() ( 
val a = super<A>.foo() 
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val b = super«B».foo() 
print("Item $a $b") 


// usage 
val item - Item() 
item.foo() 


JE Prints: A 


B 
ItemsAB 


46 A 据 X 


一 种 较为 常见 的 情况 是 ， 需 要 构建 一 个 类 ， 旨 在 存储 数据 。 例 如 ， 从 服务 器 或 本 地 数 
据 库 获取 数据 。 对 应 类 可 表示 为 应 用 程序 数据 模型 的 构造 块 ， 如 下 所 示 : 


class Product (var name: String?, var price: Double?) { 














override fun hashCode(): Int { 


var result = if (name != null) name!!.hashCode() else 0 
result = 31 * result + if (price != null) price!!.hashCode() 
else 0 


return result 
} 


override fun equals(other: Any?): Boolean = when { 


this === other -» true 

other == null || other !is Product -> false 

if (name != null) name != other.name else other.name != 
null -» false 

price !- null -> price == other.price 

else -» other.price -- null 


override fun toString(): String ( 
return "Product (name-$name, price-$price)" 


} 
在 Java F, 需要 生成 大 量 的 元 余 getter/setter. hashCode 以 及 equals 方法 ,对 此 , Android 
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Studio 可 为 我 们 创建 大 多 数 代码 ， 但 代码 维护 仍 是 一 个 重要 的 问题 。 在 Kotlin 中 ， 可 定义 
称 之 为 数据 类 的 特定 类 ， 即 向 类 声明 中 添加 data 关键 字 ， 如 下 所 示 : 


class Product (var name: String, var price: Double) 
// normal class 





data class Product (var name: String, var price: Double) 
// data class 


数据 类 通过 Kotlin 编译 器 生成 的 方法 , 向 类 中 添加 了 附加 功能 , 相关 方法 包括 equals、 
hashCode、toString、copy 以 及 多 个 componentN 方法 。 此 处 的 限制 条 件 则 是 数据 类 无 法 标 
记 为 abstract, inner 和 sealed。 下 面 详细 讨论 添加 了 数据 修饰 符 的 各 种 方法 。 


4.6.1 equals 和 hashCode 方法 





当 处 理 数 据 类 时 ， 通 常 需 要 比较 两 个 实例 架构 间 的 等 同性 (包含 相同 的 数据 。 但 不 必 
是 同一 个 实例 )。 相 应 地 ， 需 要 检测 User 类 实例 是 否 等 于 另 一 个 User 类 实例 ; 或 者 两 个 产 
品 实例 (product instance)。 常 见 的 对 象 相等 检测 模式 是 使 用 equals 方法 ， 其 内 部 采用 了 
hashCode 方法 ， 如 下 所 示 : 

product.equals (product2) 


针对 hashCode 的 重 载 实现 ， 总 体 原则 是 : 两 个 相等 的 对 象 ORAE equals 实现 ) 应 包 
含 相同 的 哈 希 码 ， 背 后 的 原因 可 解释 为 : 考虑 到 性 能 问题 ，hashCode 先 于 equals 进行 比 
较 一 一 与 对 象 中 的 各 个 字段 相 比 ， 比 较 哈 希 码 则 具有 较 好 的 性 能 。 

若 hashCode 相等 ， 则 equals 方法 负责 检测 两 个 对 象 是 否 为 同一 实例 、 同 一 类 型 ， 随 后 
通过 比较 全 部 有 效 字段 验证 相等 性 。 若 出 现 一 个 字段 不 等 ， 则 两 个 对 象 即 视 为 不 相等 。 另 一 
种 方法 可 解释 为 : 若 两 个 对 象 具有 相同 的 hashCode， 且 全 部 (比较 后 的 ) 有 效 字段 包含 相同 
值 ， 则 二 者 视 为 相等 。 下 面 考察 包含 两 个 字段 (ame 和 price) 的 Java 类 示例 ， 如 下 所 示 : 


public class Product { 





























private string name; 
private Double price; 


public Product(String name, Double price) ( 
this.name - name; 
this.price - price; 

} 


GOverride 
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public int hashCode() ( 
int result = name != null ? name.hashCode() : 0; 


result = 31 * result + (price !- null ? 
price.hashCode() : 0); 


return result; 


@override 
public boolean equals (Object o) ( 
if (this == o) { 
return true; 


) 
if (o == null || getClass() != o.getClass()) { 


return false; 


Product product - (Product) o; 


if (name != null ? !name.equals (product.name) 
product.name != null) { 
return false; 


return price !- null ? price.equals (product.price) 
product.price -- null; 


public String getName() ( 
return name; 


public void setName(String name) ( 
this.name - name; 


public Double getPrice() ( 
return price; 


public void setPrice(Double price) { 
this.price = price; 
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该 方案 广泛 应 用 于 Java 和 其 他 OOP 程序 设计 语言 中 。 早 期 ， 程 序 员 须 针对 需要 比较 的 
每 个 类 通过 手动 方式 编写 代码 并 予以 维护 , 以 确保 其 正确 性 并 针对 各 个 有 效 值 进 行 比较 。 
当前 ， 现 代 IDE 均 可 生成 此 类 代码 ， 并 对 相应 的 方法 进行 更 新 ， 例 如 Android Studio. 
读者 无 须 手工 编写 此 类 代码 ， 当 仍 须 对 此 了 予以 适当 维护 一 确保 全 部 所 需 字 段 均 经 由 
equals 方法 进行 比较 。 某 些 时 候 ， 我 们 并 不 了 解 是 否 为 IDE 生成 的 标准 代码 ， 或 者 是 调整 
后 的 版 本 一 一 对 于 各 个 Kotlin 数据 类 ， 相 关 方 法 均 由 编译 器 自动 生成 ， 因 而 并 不 会 存在 此 
类 问题 。 下 列 代码 在 Kotlin 中 定义 了 Product 类 ， 其 中 包含 了 之 前 Java 类 中 的 全 部 方法 。 
data class Product(var name: String, var price: Double) 
该 类 包含 了 定义 于 Java 中 的 全 部 方法 ， 但 存在 大 量 的 样板 代码 需要 维护 。 
第 2 章 曾 讨论 到 ， 使 用 结构 相等 操作 符 将 调用 底层 equals， 这 也 表明 ， 此 处 可 方便 、 
安全 地 比较 Product 类 实例 ， 如 下 所 示 : 


data class Product (var name:String, var price:Double) 












































val productA 
val productB 
val productC 


Product ("Spoon", 30.2) 
Product ("Spoon", 30.2) 
Product("Fork", 17.4) 


print(productA -- productA) // prints: true 

print(productA -- productB) // prints: true 

print(productB -- productA) // prints: true 

print(productA == productC) // prints: false 

print(productB -- productC) // prints: false 

RURA F, hashCode 和 equals 方法 根据 主 构造 函数 中 声明 的 各 项 属性 而 生成 。 在 大 
多 数 场合 下 ， 这 两 种 方法 已 然 足够 ， 但 若 需 要 实施 更 多 控制 ， 则 应 在 数据 类 中 重 载 这 一 类 
方法 。 此 时 ， 默 认 实 现 将 不 再 由 编译 器 生成 。 


4.6.2 toString 方法 
所 生成 的 方法 包含 主 构造 函数 中 声明 的 名 字 和 全 部 属性 值 ， 如 下 所 示 : 


data class Product(var name:String, var price:Double) 

val productA - Product("Spoon", 30.2) 

println(productA) // prints: Product (name-Spoon, price-30.2) 

实际 上 , 可 将 数据 输出 至 控制 台 或 日 志文 件 中 , 而 不 是 类 似 于 Java 中 的 类 名 和 内 存 
地 址 〈Person@a4d2e77)。 由 于 具有 人 类 可 读 的 适宜 格式 ， 因 而 可 简化 调试 处 理 过 程 。 
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4.6.3 copy 方法 


默认 条 件 下 ，Kotlin 编译 器 可 生成 copy 方法 ， 进 而 可 方便 地 创建 某 个 对 象 的 副本 ， 如 
下 所 示 : 

data class Product (var name: String, var price: Double) 

val productA = Product ("Spoon", 30.2) 

print(productA) // prints: Product (name-Spoon, price=30.2) 

val productB = productA. copy () 

print(productB) // prints: Product (name-Spoon, price-30.2) 

Java 并 不 包含 命名 参数 语法 ， 因 此 ， 当 调用 copy 方法 的 Java 代码 时 ， 需 要 传递 全 部 
参数 (参数 顺序 对 应 于 主 构造 函数 中 定义 的 属性 顺序 )。 在 Kotlin H, 该 方案 可 减少 对 copy 
构造 函数 或 copy 工厂 的 需求 。 

e copy 构造 函数 接收 单一 参数 ， 对 应 类 型 为 包含 当前 构造 函数 的 类 ， 并 返回 该 类 的 新 

实例 ， 如 下 所 示 : 


val productB = Product (productA) 

e copy 过 程 表示 为 一 类 静态 工厂 ， 并 接收 单一 参数 ， 其 类 型 为 包含 该 工厂 的 类 ， 并 返 
回 该 类 的 新 实例 ， 如 下 所 示 : 

val productB = ProductFactory.newInstance (productA) 

copy 方法 接收 与 主 构造 函数 中 声明 的 属性 对 应 的 参数 。 当 与 默认 参数 语法 结合 使 用 
可 提供 全 部 或 部 分 属性 ， 进 而 生成 调整 后 的 实例 副本 ， 如 下 所 示 : 


data class Product(var name:String, var price:Double) 





























= 


val productA = Product ("Spoon", 30.2) 
print (productA) // prints: Product (name=Spoon, price=30.2) 


val productB = productA.copy(price = 24.0) 
print (productB) // prints: Product (name-Spoon, price=24.0) 


val productC = productA.copy(price = 24.0, name = "Knife") 

print (productB) // prints: Product (name-Knife, price=24.0) 
这 可 视 作 一 种 灵活 的 对 象 副本 创建 方式 ， 进 而 可 明晰 副本 与 原始 实例 间 的 不 同 之 处 。 另 外 
一 方面 ， 程 序 设计 方案 强调 了 不 可 变性 这 一 概念 ， 并 可 利用 copy 方法 的 无 参数 调用 方便 
地 予以 实现 ， 如 下 所 示 : 
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// Mutable object - modify object state 
data class Product(var name:String, var price:Double) 


var productA = Product ("Spoon", 30.2) 
productA.name - "Knife" 


// immutable object - create new object instance 
data class Product(val name:String, val price:Double) 


var productA = Product ("Spoon", 30.2) 
productA = productA.copy(name = "Knife") 


此 处 并 未 定义 可 变 属性 〈var) 并 调整 对 象 状 态 ; 相反， 可 定义 不 可 变 属性 〈val)， 使 对 象 处 
于 不 可 变 状态 ， 通 过 获取 包含 变化 值 的 副本 对 其 进行 操作 。 该 方案 降低 了 多 线程 应 用 程序 中 
对 数据 同步 的 需求 , 以 及 与 其 相关 的 潜在 错误 数量 , 因为 不 可 变 对 象 可 在 线程 之 间 自 由 共享 。 























4.6.4 解构 声明 
某 些 时 候 ， 可 将 对 象 重 构 为 多 个 变量 ， 该 语法 称 作 解构 声明 ， 如 下 所 示 ; 


data class Person(val firstName: String, val lastName: String, 
val height: Int) 

val person - Person("Igor", "Wojda", 180) 

var (firstName, lastName, height) - person 

println(firstName) // prints: "Igor" 

println(lastName) // prints: "Wojda" 

println(height) // prints: 180 





解构 声明 可 一 次 性 地 创建 多 个 变量 。 在 上 述 代 码 中 ， 将 生成 firstName, lastName 和 


height 变量 。 从 底层 来 看 ， 编 译 器 将 生成 如 下 代码 : 


val person = Person("Igor", "Wojda", 180) 
var firstName = person.componentl() 

var lastName = person.component2 () 

var height = person.component3() 





对 于 数据 类 主 构造 函数 中 声明 的 各 个 属性 ，Kotlin 编译 器 生成 单一 的 componentN 77 


ik. component 方法 后 缀 对 应 于 主 构造 函数 中 声明 的 属性 顺序 。 因 此 ，firstName 对 应 于 








componentl, lastName 对 应 于 component2, height 对 应 于 component3 。 实 际 上 ， 可 直接 在 
Person 类 上 调用 此 类 方法 以 获取 属性 值 ， 但 这 里 并 无 此 必要 一 一 对 应 的 名 称 不 包含 实际 含 














义 ， 代 码 也 难以 阅读 和 维护 。 针 对 对 象 的 解构 ， 可 将 此 类 方法 留 与 编译 器 ， 并 使 
person.firstName 这 一 类 属性 访问 语法 。 








用 诸如 
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另外 ， 当 使 用 下 划 线 时 ， 还 可 忽略 一 个 或 多 个 属性 ， 如 下 所 示 : 


val person = Person("Igor", "Wojda", 180) 
var (firstName, , height) = person 
println(firstName) // prints: "Igor" 
println(height) // prints: 180 


代码 仅 须 生成 两 个 变量 ， 即 firstName 和 height. 4}, lastName 将 被 忽略 。 编 译 器 生成 的 
代码 如 下 所 示 : 
val person = Person("Igor", "Wojda", 180) 


var firstName- person.componentl() 
var height = person.component3() 


同时 ， 还 可 像 String 那样 对 简单 类 型 进行 解构 ， 如 下 所 示 : 


val file = "MainActivity.kt" 
val (name, extension) = file.split(".", limit = 2) 


最 后 ， 解 构 声明 还 可 与 for 循环 结合 使 用 ， 如 下 所 示 : 


val authors = listOf( 
Person("Igor", "Wojda", 180), 
Person("Marcin", "Moskała", 180 























) 


println("Authors:") 

for ((name, surname) in authors) { 
println("$name $surname") 

} 


4.7 操作 符 重 载 


Kotlin 中 包含 了 预定 义 操作 符 集 合 ， 并 使 用 特定 的 符号 表达 方式 (例如 +、* 等 ) 和 优 
先 级 。 大 多 数 操作 符 可 直接 转换 为 方法 调用 ; 某 些 操作 符 则 可 转换 为 更 加 复杂 的 表达 式 。 
K 4.4 显示 了 Kotlin 中 的 操作 符 列表 。 








表 4.4 
操作 符 标记 对 应 的 方法 /表达 式 
atb a.plus(b) 
a-b a.minus(b) 
a*b a.times(b) 
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续 表 

操作 符 标记 对 应 的 方法 /表达 式 
a/b a.div(b) 

a%b a.rem(b) 

a..b a.rangeTo(b) 
at=b a.plusAssign(b) 
a-=b a.minusAssign(b) 
a*=b a.timesAssign(b) 
a/=b a.divAssign(b) 
a%=b a.remAssign(b) 

att a.inc() 

a-- a.dec() 
ainb b.contains(a) 
alinb !b.contains(a) 

a[i] a.get(i) 
afi, j] a.get(i, j) 

afi_l, ...i n] a.get(i_l, ..., i_n) 

a[i] =b a.set(i, b) 
afi, jJ=b a.set(i, j, b) 
afi_l,...,in]=b aset(i l,...i n b) 

a() a.invoke() 

a(i) a.invoke(i) 

a(i, j) a.invoke(i, j) 

a(i_l, ..., i_n) ainvoke(i l,...i n) 
a=b a?.equals(b) ?: (b === null) 
al=b !(a?.equals(b) ?: (b == null)) 

a>b a.compareTo(b) > 0 

a<b a.compareTo(b) < 0 
a>=b a.compareTo(b) >= 0 
a<=b a.compareTo(b) — 0 














Kotlin 编译 器 将 表示 特定 操作 符 〈 表 中 的 左 列 ) 的 标记 转换 为 将 被 调用 的 对 应 方法 或 
KREA AF). 

针对 各 项 操作 符 ， 可 提供 自 定 义 实现 ， 也 就 是 说 ， 在 与 operator 标记 相符 的 类 operator 
方法 中 对 其 加 以 使 用 。 下 面 定 义 一 个 包含 x，y 属性 ， 以 及 plus 和 times 操作 符 的 Point 类 。 
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data class Point (Var x: Double, var y: Double) ( 


de 


operator fun plus(point: Point) = Point(x + point.x, y+ point.y) 


operator fun times(other: Int) = Point(x * other, y * other) 
} 


// usage 
var pl = Point(2.9, 5.0) 
var p2 = Point(2.0, 7.5) 


println(pl + p2) // prints: Point(x-4.9, y-12.5) 
println(pl * 3) // prints: Point(x-8.7, y-21.0) 


通过 定义 plus 和 times 操作 符 ， 可 在 任意 Point 实例 上 执行 加 法 和 乘法 操作 。 每 次 调用 + 或 
* 操 作 符 时 ，Kotlin 调用 对 应 的 操作 符 方法 plus 或 imes。 实 际 上 ， 编 译 器 将 生成 下 列 方法 


调 





























pl.plus (p2) 
pl.times (3) 


在 当前 示例 中 ， 向 plus 操作 符 传递 了 另 一 个 point 实例 ， 该 类 型 并 非 是 强制 性 的 。 操 作 
符 方法 实际 上 并 未 重 载 源 自 超 类 的 方法 ， 因 而 未 包含 基于 特定 参数 和 特定 类 型 的 声明 。 
同时 ， 无 须 继承 特定 的 Kotlin 类 型 以 重 载 操作 符 。 全 部 所 需 内 容 表示 为 一 个 方法 ， 且 
包含 了 标记 为 operator 的 签名 。Kotlin 编译 器 通过 运行 对 应 当前 操作 符 的 相关 方法 执行 
其 余 内 容 。 实 际 上 ， 可 定义 包含 相同 名 称 和 不 同 参数 类 型 的 多 个 操作 符 ， 如 下 所 示 : 








data class Point(var x: Double, var y: Double) { 


operator fun plus (point: Point) = Point (x + point.x, y +point.y) 


operator fun plus(vector:Double) = Point(x + vector, y + vector) 


} 


Point(2.9, 5.0) 
Point(2.0, 7-5) 


var pl = 
var p2 = 
printin(pl + p2) // prints: Point (x=4.9, y-12.5) 
printin(pl + 3.1) // prints: Point (x=6.0, y=10.1) 


两 个 操作 符 均 工作 良好 一 一 Kotlin 编译 器 可 选取 操作 符 的 适当 重 载 结果 。 另 外 ， 许 多 基 
本 操作 符 还 包含 对 应 的 复合 赋值 操作 符 (plus 包含 plusAssign，times 包含 times Assign, 
等 等 )。 因 此 ， 当 定义 诸如 + 这 一 类 操作 符 时 ，Kotlin 支持 + 操作 和 += 操 作 ， 如 下 所 示 : 
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var pl = Point(2.9, 7.0) 
var p2 — Point(2.0, 7.5) 


pl += p2 

println(pl) // prints: Point(x-4.9, y-14.5) 

在 性 能 要 求 较 为 严格 的 场合 下 ， 应 注意 不 同方 案 之 间 的 差异 。 复 合 赋值 操作 符 〈 例 如 
+= 操 作 符 ) 包含 Unit 返回 类 型 ， 因 而 仅 调整 现 有 对 象 的 状态 ， 而 基本 操作 符 ( 例 如 + 操作 
符 ) 通常 返回 某 个 对 象 的 新 实例 ， 如 下 所 示 : 

var pl = Wallet(39.0, 14.5) 

pl += p2 // update state of pl 

val p3 = pl + p2 //creates new object p3 

当 定 义 包 含 相同 参数 类 型 的 plus 和 plusAssign 操作 符 ， 并 尝试 使 用 plusAssign (复合 ) 
BETIS, 编译 器 将 抛 出 错误 , 其 原因 在 于 编译 器 并 不 知晓 应 调用 哪 一 个 方法 , 如 下 所 示 : 

data class Point (var x: Double, var y: Double) { 

inie f 
println("Point created $x.$y") 
































li 
operator fun plus(point: Point) = Point(x + point.x, y + point.y) 


operator fun plusAssign(point:Point) ( 
X += point.x 
y += point.y 


) 


// usage 

var pl - Point(2.9, 7.0) 

var p2 - Point(2.0, 7.5) 

val p3 = pl + p2 

pl += p2 // Error: Assignment operations ambiguity 


操作 符 重 载 同 样 适用 于 定义 Java 中 的 类 。 全 部 工作 仅 须 定义 包含 适当 签名 和 名 称 的 方 
法 (对 应 于 操作 符 的 方法 名 )。Kotlin 编译 器 将 操作 符 应 用 转换 为 该 方案 。 另 外 ，Java 中 不 
存在 操作 符 修 饰 符 ， 因 而 Java 类 中 对 其 也 不 予 涉 及 ， 如 下 所 示 : 
// Java 
public class Point ( 
private final int x; 


private final int y; 
public Point(int x, int y) ( 
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this.x = x; 
this.y = y; 

} 

public int getX() { 
return x; 

} 

public int getY() { 
return y; 

it 

public Point plus(Point point) { 
return new Point (point.getX() + x, point.getY() + y); 


} 


// Main. kt 
val pl = Point(1, 2) 
val p2 = Point(3, 4) 


val p3 = pl + p2; 
println("$x:(p3.x), y:${p3.y}") //prints: x:4, y:6 


48 sp $ E 
在 Java 中 , 存在 多 种 方式 可 声明 单 例 。 一 种 较为 常见 的 方式 是 定义 一 个 包含 私有 构造 
函数 的 类 ， 并 通过 静态 工厂 方法 获取 实例 ， 如 下 所 示 : 


public class Singleton ( 


private Singleton() ( 
) 


private static Singleton instance; 
public static Singleton getInstance() ( 


if (instance == null) { 
instance - new Singleton(); 


return instance; 
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上 述 代码 针对 单 例 线程 工作 良好 ， 但 并 不 具备 线程 安全 性 。 因 此 ， 在 某 些 场合 下 ， 可 创建 
两 个 Singleton 实例 。 对 此 ， 存 在 多 种 方式 可 对 其 进行 修正 。 例 如 ， 下 列 代码 采用 了 
synchronized 代码 块 。 


// synchronized 
public class Singleton ( 



































private static Singleton instance - null; 


private Singleton()( 
) 


private synchronized static void createInstance() ( 
if (instance == null) { 
instance = new Singleton(); 
) 
) 


public static Singleton getInstance() ( 
if (instance -- null) createInstance(); 
return instance; 


} 
然而 ， 上 述 代码 仍 稍 显 元 余 。 在 Kotlin 中 ， 针 对 称 作对 象 声 明 的 单 例 构建 ， 存 在 一 种 特定 
的 语言 结构 , 并 可 采用 更 加 简单 的 方式 实现 相同 结果 。 定义 对 象 的 过 程 与 定义 类 十 分 类 似 ， 
唯一 的 差别 在 于 使 用 object 关键 字 ， 而 非 class 关键 字 ， 如 下 所 示 : 

object Singleton 

另外 ， 还 可 采用 与 类 相同 的 方式 ， 向 对 象 声 明 添 加 方法 和 属性 ， 如 下 所 示 : 


object SQLiteSingleton { 
fun getAllUsers(): List<User> { 
We w 
































} 
} 


该 方法 与 任意 Java 静态 类 的 方法 访问 方式 均 保 持 相 同 ， 如 下 所 示 : 
SQLitesingleton.getAllUsers () 


对 象 声 明 可 实现 延迟 初始 化 ， 并 可 媒 套 于 其 他 对 象 声 明 或 非 内 部 类 中 。 另 外 ， 对 象 声 
明 不 可 被 赋予 某 个 变量 中 。 
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49 ”对象 表达 式 


对 象 表达 式 等 价 于 Java 中 的 匿名 类 , 用 于 实例 化 继承 自 某 个 类 或 实现 了 某 个 接口 的 对 
象 。 对 此 ， 较 为 经 典 的 用 例 是 需要 定义 实现 了 某 个 接口 的 对 象 。 下 列 代码 显示 了 在 Java 中 ， 
如 何 实现 ServiceConnection 接口 ， 并 将 其 赋予 某 个 变量 。 

ServiceConnection serviceConnection = new ServiceConnection() ( 


@override 
public void onServiceDisconnected (ComponentName name) { 





) 


GOverride 

public void onServiceConnected (ComponentName name, 
IBinder service) 

t 


) 
针对 上 述 实现 ，Kotlin 中 最 为 接近 的 实现 方式 如 下 所 示 : 
val serviceConnection = object: ServiceConnection ( 


override fun onServiceDisconnected (name: ComponentName?) ( } 


override fun onServiceConnected (name: ComponentName?, 
service: IBinder?) ( ) 
5 





4 前 示例 采用 了 一 个 对 象 表达 式 ， 并 生成 实现 了 ServiceConnection 接口 的 匿名 类 实例 。 除 
此 之 外 , 对 象 表达 式 还 可 进一步 扩展 类 。 下 列 代码 显示 了 如 何 生成 抽象 类 Broadcast Receiver 
的 实例 。 

val broadcastReceiver = object : BroadcastReceiver() ( 


override fun onReceive(context: Context, intent: Intent) { 
printin("Got a broadcast ${intent.action}") 





























} 


val intentFilter = IntentFilter ("SomeAction") ; 
registerReceiver (broadcastReceiver, intentFilter) 
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对 象 表 达 式 可 生成 匿名 类 型 的 对 象 〈 实 现 了 某 个 接口 ) 并 扩展 某 个 类 ， 此 外 ， 还 可 据 此 方 
便 地 处 理 与 适配器 模式 相关 的 某 些 有 趣 问题 。 
适配器 设计 模式 允许 将 一 个 类 的 接口 转换 为 客户 期 望 的 接口 ， 从 而 使 不 
兼容 的 类 能 够 协同 工作 
下 列 代码 定义 了 一 个 Player 接口 ， 以 及 一 个 以 Player 作为 参数 的 接口 。 


interface Player { 
fun play() 














) 


fun playWith(player: Player) ( 
print("I play with") 
player.play() 

} 


另外 ， 此 处 使 用 了 公共 库 中 定义 的 VideoPlayer 类 ， 该 类 包含 了 一 个 定义 的 play 方法 ， 但 
并 未 实现 当前 的 Player 接口 ， 如 下 所 示 : 


open class VideoPlayer ( 
fun play() ( 
println("Play video") 








} 
} 
VideoPlayer 满足 全 部 接口 需求 条 件 ， 但 无 法 作为 Player 被 传递 一 一 未 实现 当前 接口 
当 用 作 player 时 ， 需 要 定义 一 个 适配器 。 在 当前 示例 中 ， 须 将 其 实现 为 匿名 类 型 对 象 ， 
时 实现 了 Player 接 > W FAR: 


val player = object: VideoPlayer(), Player ( } 
playWith (player) 


这 里 ， 无 须 定 义 VideoPlayer 子 类 即 可 解决 当前 问题 。 另 外 ， 可 在 对 象 表达 式 中 实现 
自 定义 方法 ， 如 下 所 示 : 


val data = object { 
var size = 1 
fun update() ( 
Vhs 











o 














可 


























} 


f 
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data.size = 2 
data .update() 


为 一 种 非常 简便 的 方法 ， 代 码 自 定 义 了 匿名 对 象 ， 这 在 Java 中 尚 无 法 体现 。 当 在 Java 











中 定义 类 似 的 类 型 时 ， 须 自 定义 接口 。 当 前 ， 可 向 VideoPlayer 类 添加 某 种 操作 行为 ， 并 





完整 实现 Player 接口 ， 如 下 所 示 : 


4 


open class VideoPlayer { 
fun play() { 
println("Play video") 
) 
j 


interface Player{ 
fun play() 
fun stop() 

H 


// usage 
val player - object: VideoPlayer(), Player ( 


var duration:Double - 0.0 


fun stop() ( 
println("Stop video") 
} 
} 


player.play() // println("Play video") 
player.stop() // println("Stop video") 
player.duration - 12.5 





其 中 ， 可 调用 定义 于 VideoPlayer 类 和 表达 式 对 象 中 的 匿名 对 象 (player). 方法 。 





410 伴生 对 和 象 


与 Java 不 同 ，Kotlin 缺乏 定义 静态 方法 的 能 力 ， 但 可 定义 与 某 个 类 关联 的 对 象 。 换 而 











言 之 ， 某 个 对 象 仅 初始 化 一 次 ， 因 而 仅 存在 对 象 的 唯一 实例 ， 并 在 特定 类 的 全 部 实例 间 共 











状态 。 当 单 例 对 象 与 同名 类 关联 时 ， 称 作 伴生 对 象 ， 对 应 类 称 作 该 类 的 伴生 类 ， 如 











R) 








4.1 所 示 。 
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图 4.1 
图 4.1 中 显示 了 Car 类 的 3 个 实例 ， 并 共享 某 个 对 象 的 单一 实例 。 











定义 于 伴随 对 象 中 的 成 员 《〈 例 如 方法 和 属性 )， 可 采用 与 Java 访问 静态 字段 和 方法 类 
似 的 方式 予以 访问 。 伴 生 对 象 的 主要 功能 是 ， 令 代码 与 类 相关 联 ， 而 不 必 针 对 特定 的 类 实 
例 。 相 对 于 Java 中 的 静态 成 员 ， 一 种 较 好 的 成 员 定义 方式 是 工厂 模式 ， 进 而 生成 类 实例 方 
法 。 当 定义 最 简单 的 伴生 对 象 时 ， 须 定义 一 个 独立 的 代码 块 ， 如 下 所 示 : 


class ProductDetailsActivity { 

















companion object { 
) 
} 


下 面 定义 一 个 start 方法 ， 并 以 一 种 较为 简单 的 方式 启动 某 项 操作 〈activity)， 如 下 
所 示 : 
// ProductDetailsActivity.kt 
class ProductDetailsActivity : AppCompatActivity() { 
override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
val product = intent.getParcelableExtra<Product> 
(KEY PRODUCT) // 3 


Ilann 
i 


companion object ( 
const val KEY PRODUCT - "product" // 1 
fun start(context: Context, product: Product) ( // 2 
val intent - Intent (context, 


ProductDetailsActivity::class.java) 
intent.putExtra(KEY PRODUCT, product) // 3 
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context.startActivity (intent) 


l 


// Start activity 
ViewProductActivity.start(context, productId) // 2 


e 对 于 注释 1， 仅 存在 key 的 单 实例 。 

se 无须 生 成 对 象 实例 即 可 调用 start 方法 ， 这 一 点 类 似 于 Java 中 的 静态 方法 。 

e 实例 创建 后 获取 数值 。 

需要 注意 的 是 ， 可 在 操作 生成 之 前 调用 start。 下 面 利 用 伴生 对 象 跟踪 Car 类 实例 的 创 
建 方式 。 对 此 ， 需 要 定义 包含 私有 setter 的 count 属性 ， 除 此 之 外 ， 还 可 定义 为 顶级 属性 。 
但 较 好 的 方法 是 将 其 置 于 伴生 对 象 中 ， 其 原因 在 于 : 不 希望 在 当前 类 外 部 修改 count， 如 
下 所 示 : 

class Car { 

init { 
count++; 
























































} 


companion object { 
var count:Int = 0 
private set 


) 


该 类 可 访问 定义 于 伴生 对 象 中 的 全 部 方法 和 属性 ， 但 伴生 对 象 则 无 法 访问 类 内 容 。 伴 
生 对 象 被 赋予 一 个 类 中 ， 而 非特 定 的 实例 ， 如 下 所 示 : 








println(Car.count) // Prints 0 
Car() 
Car() 
println(Car.count) // Prints: 2 


当 直 接 访问 伴生 对 象 实例 时 ， 可 使 用 类 名 。 
可 通过 稍 显 复 杂 的 语法 访问 伴生 对 象 ， 例 如 Car.Companion.count。 但 大 
多 数 时 候 则 无 此 必要 ， 除 非 需要 从 Java 代码 中 访问 companion. 


伴生 对 象 表示 为 伴生 类 创建 的 单 体 ， 并 保持 其 静态 属性 。companion 对 象 采 用 延迟 初 
始 化 方式 ， 这 也 意味 着 ，companion 对 象 在 首次 需要 时 予以 实例 化 。 例 如 ， 访 问 其 成 员 时 ， 
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或 者 包含 companion 对 象 的 类 实例 被 创建 时 。 当 标识 何 时 创建 Car 类 实例 及 其 对 应 的 伴生 
对 象 时 ， 须 添加 两 个 初始 化 代码 块 ， 分 别 对 应 于 Car 类 和 伴生 对 象 。 
伴生 对 象 中 初始 化 代码 块 的 工作 方式 与 类 相同 一 一 当 创 建 实例 时 被 执行 ， 如 下 所 示 : 
class Car { 
init { 
count++; 
println("Car created") 














) 


companion object ( 
var count: Int = 0 
init ( 
println("Car companion object created") 
it 
) 
} 


类 初始 化 代码 块 等 价 于 Java 的 构造 方法 体 ; 而 编译 对 象 初始 化 代码 块 则 与 Java 静态 
初始 化 代码 块 等 价 。 当 前 ，count 属性 可 通过 任意 客户 端 进行 更 新 一 一 该 属性 可 在 Car 外 
部 访问 ， 稍 后 将 对 这 一 问题 进行 修正 。 下 面 尝 试 访问 Car 伴生 对 象 的 类 成 员 ， 如 下 所 示 : 

Car.count // Prints: Car companion object created 

Car() // Prints: Car created 

当 访 问 定义 于 伴生 对 象 的 count 属性 时 ， 将 引发 该 对 象 的 创建 过 程 。 需 要 注意 的 是 ， 
此 处 并 未 生成 Car 类 实例 。 稍 后 将 讨论 ， 当 生成 Car 类 时 ，companion 对 象 已 创建 完毕 。 
下 面 考察 Car 类 的 实例 化 操作 ， 并 于 随后 访问 companion 对 象 ， 如 下 所 示 : 

Car() 


// Prints: Car companion object created 
// Prints: Car created 




















Car() // Prints: Car created 

Car.count 

伴生 对 象 随 首 个 Car 类 实例 而 被 创建 ， 因 此 ， 当 生成 其 他 用 户 类 实例 时 ， 针 对 该 类 的 

companion 对 象 已 然 存 在 ， 且 无 须 创建 。 

注意 ， 前 述 实 例 化 机 制 描述 了 两 个 单独 示例 ， 这 两 种 情况 在 单一 程序 中 均 不 可 能 成 

立 一 一 仅 可 存在 唯一 的 类 companion 对 象 实 例 ， 并 在 需要 时 首次 创建 。 
companion 对 象 还 可 定义 函数 、 实 现 相关 接口 ， 甚 至 是 扩展 类 。 对 此 ， 可 定义 一 个 伴生 

对 象 ， 在 其 中 定义 包含 附加 功能 项 的 静态 方法 ， 并 针对 测试 目的 予以 重 载 实 现 ， 如 下 所 示 : 
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abstract class Provider<T> ( // 1 
abstract fun creator(): T // 2 


private var instance: T? - null // 3 
var override: T? - null // 4 


fun get(): T = override ?: instance ?: creator().also ( instance = it 
) //5 
) 
e 针对 注释 1, Provider 定义 为 泛 型 类 。 
e 针对 注释 2， 抽 象 函数 用 于 创建 实例 。 
e 针对 注释 3， 对 应 字段 用 于 保存 创建 后 的 实例 。 
e 针对 注释 4， 该 字段 用 于 测试 目的 ， 并 提供 实例 的 蔡 代 实 现 。 
e 针对 注释 S， 该 函数 返回 重 载 后 的 实例 〈 若 已 设置 )， 或 者 创建 后 的 实例 化 操作 ， 抑 
或 通过 create 方法 生成 实例 ， 并 以 此 填充 实例 字段 。 
根据 此 类 实现 ， 即 可 定义 包含 默认 静态 构造 器 的 接口 ， 如 下 所 示 : 


interface MarvelRepository { 














fun getAllCharacters (searchQuery: String?): 
Single<List<MarvelCharacter>> 


companion object : Provider<MarvelRepository>() { 
override fun creator() = MarvelRepositoryImpl() 
} 
} 


当 获 取 实 例 时 ， 需 要 使 用 
MarvelRepository.get () 


出 于 测试 目的 ， 如 果 需 要 确定 其 他 实例 〈 例 如 Espresso 测试 )， 通 常 可 采用 对 象 表达 
式 予 以 确定 ， 如 下 所 示 : 


MarvelRepository.override = object : MarvelRepository { 
override fun getAllCharacters (searchQuery: String?): 
Single<List<MarvelCharacter>> { 

baee 
} 
} 





伴生 对 象 在 Kotlin Android 开发 中 十 分 常见 ， 常 用 于 定义 Java 中 的 静态 数据 元 素 ( 常 
量 字 段 、 静 态 创建 方法 等 )， 但 也 会 提供 其 他 一 些 附 加 功能 项 。 
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41 K 举 类 


枚 举 类 型 Cenum) 定义 为 一 种 数据 类 型 ， 并 由 一 组 命名 值 构成 。 当 定义 enum 类 型 时 ， 
需要 向 类 声明 中 添加 enum 关键 字 ， 如 下 所 示 : 
enum class Color ( 
RED, 
ORANGE, 
BLUE, 
GRAY, 
VIOLET 
H 


val favouriteColor - Color.BLUE 
若 将 字符 串 解 析 为 enum， 可 使 用 valueOf 方 法 (与 Java 类 似 )， 如 下 所 示 : 


val selectedColor = Color.valueOf ("BLUE") 
println(selectedColor == Color.BLUE) // prints: true 


或 者 使 用 Kotlin 中 的 帮助 方法 ， 如 下 所 示 : 


val selectedColor = enumValueOf<Color> ("BLUE") 
println(selectedColor -- Color.BLUE) // prints: true 


当 显示 Color 枚 举 值 中 的 全 部 值 时 ， 可 使 用 values 函数 (与 Java 类 似 )， 如 下 所 示 : 


for (color in Color.values()) ( 
println("name: ${it.name}, ordinal: ${it.ordinal}") 





) 
或 者 使 用 Kotlin 中 的 enumerateValues 帮助 函数 ， 如 下 所 示 : 


for (color in enumValues<Color>()) { 
println("name: ${it.name}, ordinal: ${it.ordinal}") 





} 


// Prints: 

name: RED, ordinal: 0 
name: ORANGE, ordinal: 1 
name: BLUE, ordinal: 2 
name: GRAY, ordinal: 3 
name: VIOLET, ordinal: 4 























另外 ，enum 类 型 还 可 包含 构造 方法 ， 以 及 与 各 个 enum 常量 关联 的 自 定 义 数据 。 下 
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利用 red. green. blue 颜色 分 量 值 添 加 属性 ， 如 下 所 示 : 


enum class Color(val r: Int, val g: Int, val b: 
RED(255, 0, 0), 
ORANGE (255, 165, 0), 
BLUE(0, 0, 255), 
GRAY (49, 79, 79), 
VIOLET (238, 130, 238) 














} 


val color = Color.BLUE 
val rValue =color.r 
val gValue = color.g 
val bValue = color.b 


据 此 ， 可 针对 各 种 颜色 定义 RGB 值 计算 函数 。 


Int) 


{ 


#125" 


注意 ， 如 果 在 最 后 一 个 常量 CVIOLET) 之 后 添加 分 号 ， 将 把 常量 定义 从 成 员 定义 中 


分 离开 来 ， 这 在 Kotlin 中 较 少 出 现 ， 如 下 所 示 : 


enum class Color(val r: Int, val g: Int, val b: 
BLUE(0, 0, 255), 
ORANGE(255, 165, 0), 
GRAY(49, 79, 79), 
RED(255, 0, 0), 
VIOLET(238, 130, 238); 


fun rdb() = ar isha T6 mq shi 8 Eb. 
fun printHex(num: Int) ( 


println (num.toString(16)) 


printHex(Color.BLUE.rgb()) // Prints: ff 
printHex(Color.ORANGE.rgb()) // Prints: ffa500 
printHex(Color.GRAY.rgb()) // Prints: 314f4f 


Int) 


{ 


rgb0 方 法 针对 某 个 特定 枚 举 值 访问 r、g、b， 并 针对 每 个 enum 数据 元 素 单 独 计算 对 应 


值 。 另 外 ， 还 可 通过 init 代码 块 向 枚 举 构造 方法 参数 中 加 入 验证 机 制 ， 寿 














要 使 用 到 下 列 函 数 : 


enum class Color(val r: Int, val g: Int, val b: 
BLUE(0, 0, 255), 
ORANGE(255, 165, 0), 
GRAY(49, 79, 79), 
RED(255, 0, 0), 








Int) 


{ 


h， 则 需 





E Kotlin 4 
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VIOLET(238, 130, 238); 


init ( 
require(r in 0..255) 
require(g in 0..255) 
require(b in 0..255) 


fun rgb() = r shl 16 + g shl 8 + b 
$ 


定义 错误 的 枚 举 值 将 会 导致 异常 ， 如 下 所 示 : 

GRAY(33, 33, 333) // IllegalArgumentException: Failed requirement 

某 些 时 候 ， 需 要 将 不 同 的 操作 行为 关联 至 各 个 常量 上 。 对 此 ， 可 定义 抽象 方法 或 属性 ， 
并 在 各 个 枚 举 代码 块 中 对 其 进行 重 载 。 下 面 定义 枚 举 Temperature 和 temperature 属性 : 


enum class Temperature ( COLD, NEUTRAL, WARM } 




















enum class Color(val r: Int, val g: Int, val b: Int) ( 
RED(255, 0, 0) ( 
override val temperature 


Temperature.WARM 

by 

ORANGE (255, 165, 0) { 
override val temperature 


Temperature .WARM 
hy 
BLUE(0, 0, 255) { 

override val temperature 


Temperature.COLD 
hr 
GRAY (49, 79, 79) { 
override val temperature = Temperature.NEUTRAL 
fz 
VIOLET (238, 130, 238 { 
override val temperature = Temperature .COLD 


init { 
require(r in 0..256) 
require (g in 0..256) 
require (b in 0..256) 


fun rgb) = (£ * 256 + g) * 256 +D 
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abstract val temperature: Temperature 
} 


println(Color.BLUE.temperature) //prints: COLD 
println(Color.ORANGE.temperature) //prints: WARM 
println(Color.GRAY.temperature) //prints: NEUTRAL 


目前 ， 每 种 颜色 步 进 包 含 了 RGB 信息 ， 而 且 还 涵盖 了 描述 其 温度 的 附加 枚 举 值 。 此 处 已 
添加 了 一 项 属性 ， 采 用 类 似 的 方式 还 可 向 每 个 枚 举 元 素 添 加 自 定义 方法 。 


4.12 命名 方法 的 中 组 调用 























中 绥 调 用 可 视 作 Kotlin 的 特征 之 一 ， 进 而 可 生成 流畅 且 具 有 可 读 性 的 代码 。 中 绥 调 用 
使 得 代码 编写 方式 更 接近 于 人 类 语言 。 第 2 章 曾 讨论 了 中 绥 方 法 ， 并 可 方便 地 创建 Pair 类 
实例 ， 如 下 所 示 : 

var pair = "Everest" to 8848 

Pair 类 表示 为 包含 两 个 值 的 泛 型 对 ， 在 该 类 中 ， 数 值 并 不 存在 具体 含义 ， 因 而 可 用 于 
各 种 用 途 。 这 里 ，Pair 定义 为 一 个 数据 类 , 因而 包含 了 全 部 数据 类 方法 (equals、hashCode、 
componentl 等 )。 下 列 代码 显示 了 Kotlin 标准 库 中 Pair 类 的 定义 。 


public data class Pair«out A, out B>( // 1 
public val first: A, 
public val second: B 

) : Serializable ( 


























public override fun toString(): String = "($first, $second)" 
7/59: 
} 
e 针对 注释 1， 泛 型 背后 所 用 的 out 修饰 符 的 含义 将 在 第 6 章 加 以 讨论 。 
e 针对 注释 2, Pair 包含 了 一 个 自 定义 toString 方法 , 其 实现 使 得 输出 语法 更 具 可 读 性 ; 
而 第 一 个 和 第 二 个 名 称 在 大 多 数 使 用 环境 下 并 不 具备 实际 含义 。 
在 深入 讨论 中 组 方法 的 定义 方式 之 前 ， 下 面 首先 将 所 述 代码 转换 为 较为 熟悉 的 形式 。 
每 种 中 缀 方法 均 可 像 其 他 方法 那样 使 用 ， 如 下 所 示 : 


val mountain = "Everest"; 
var pair = mountain.to (8848) 
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实际 上 ， 中 级 可 简单 地 表示 为 方法 调用 ， 且 无 须 使 用 点 号 操作 符 和 调用 操作 符 〈 即 括号 )。 
中 级 标识 仅 是 外 观 不 同 , 但 仍 可 视 为 常规 的 方法 调用 。 在 之 前 的 例子 中 , 可 简单 地 在 String 
类 接口 上 调用 to 方法 。 这 里 ，to 表示 为 扩展 函数 ， 第 7 章 将 对 此 了 予以 解释 。 当 前 ， 可 假设 
to 表示 为 String 类 中 的 一 个 方法 ， 并 返回 包含 自身 和 传递 参数 的 Pair 实例 。 随 后 ， 可 在 返 
可 的 Paix 上 像 其 他 数据 类 对 象 那样 进行 操作 ， 如 下 所 示 : 

val mountain = "Everest"; 

var pair = mountain.to (8848) 

println(pair.first) //prints: Everest 

println(pair.second) //prints: 8848 
在 Kotlin 中 ， 该 方法 仅 在 包含 单一 参数 时 可 实现 中 绥化 。 另 外 ， 中 组 标识 并 不 会 自动 出 
现 一 一 须 显 式 地 将 该 方法 标记 为 infix。 下 面 利 用 中 缀 方法 定义 Point 类 ， 如 下 所 示 : 

data class Point(val x: Int, val y: Int) ( 

infix fun moveRight(shift: Int) = Point(x + shift, y) 
















































































) 
Usage example: 


val pointA - Point(1,4) 

val pointB = pointA moveRight 2 

println(pointB) //prints: Point(x-3, y-4) 
需要 注意 的 是 ， 此 处 创建 了 一 个 新 的 Point 实例 ， 并 可 对 现 有 实例 进行 修改 〈 若 为 可 变 类 
型 )。 另 外 ， 中 组 也 常 与 不 可 变 类 型 结合 使 用 。 

我 们 还 可 将 infix 方法 和 枚 举 值 结 合 使 用 ， 进 而 实现 更 为 流畅 的 语法 。 下 面 考察 经 典 
的 纸牌 游戏 中 的 每 幅 纸牌 ， 其 中 包括 梅花 、 方 片 、 红 心 和 黑 桃 ， 如 图 42 所 示 。 
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图 4.2 
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i) 图 像 资源 源 自 https://mathematica. stackexchange.com/questions/16108/standard- 
deck-of-52-playing-cards-incurated-data. 


当前 目标 是 定义 相关 语法 ， 根 据 花 色 确 定 纸牌 ， 并 按照 下 列 方式 排列 : 
val card = KING of HEARTS 
首先 ， 需 要 定义 两 种 枚 举 值 表示 全 部 排列 和 花色 ， 如 下 所 示 


enum class Suit ( 
HEARTS, 
SPADES, 
CLUBS, 
DIAMONDS 





) 


enum class Rank ( 
TWO, THREE, FOUR, FIVE, 
SIX, SEVEN, EIGHT, NINE, 
TEN, JACK, QUEEN, KING, ACE; 
} 


随后 ， 需 要 定义 一 个 类 ， 表 示 由 排列 和 花色 构成 的 纸牌 ， 如 下 所 示 
data class Card(val rank: Rank, val suit: Suit) 
接 下 来 ， 可 按照 下 列 方 式 实例 化 Card 25: 
val card = Card(Rank.KING, Suit.HEARTS) 
为 了 进一步 简化 语法 ， 可 向 Rank 枚 举 值 中 引入 新 的 中 组 方法 ， 如 下 所 示 : 


enum class Rank { 
TWO, THREE, FOUR, FIVE, 
SIX, SEVEN, EIGHT, NINE, 
TEN, JACK, QUEEN, KING, ACE; 


infix fun of(suit: Suit) - Card(this, suit) 
l 
据 此 ， 可 生成 Card 调用 ， 如 下 所 示 : 
val card = Rank.KING.of (Suit.HEARTS) 
由 于 对 应 方法 标记 为 infix， 因 而 可 移 除 点 号 调用 操作 符 和 括号 ， 如 下 所 示 : 


val card = Rank.KING of Suit.HEARTS 
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静态 导入 的 运用 可 进一步 简化 语法 ， 进 而 实现 最 终 目标 ， 如 下 所 示 : 


import Rank.KING 
import Suit.HEARTS 


val card = KING of HEARTS 


除了 简单 之 外 ， 上 述 代码 还 具有 100% 的 类 型 安全 性 。 也 就 是 说 ， 仅 可 通过 预定 义 的 
Rank 和 Suit 枚 举 值 定义 纸牌 ， 且 无 法 错误 地 确定 某 些 不 存在 的 纸牌 。 


4.13 ”可 见 性 修饰 符 


Kotlin 支持 4 种 类 型 的 可 见 性 修饰 符 ( 访 问 修饰 符 )， 即 private. protected. public 和 
internal, Kotlin 并 不 支持 包 -private Java 修饰 符 。 此 处 ,二 者 间 的 主要 差别 在 于 ,Kotlin 中 ， 
默认 的 可 见 性 修饰 符 为 public， 无 须 对 其 进行 显 式 定义 ， 因 而 对 特定 声明 可 予以 忽略 。 全 
部 修饰 符 均 可 应 用 于 各 种 数据 元 素 上 ， 并 可 根据 声明 位 置 划分 为 两 组 ， 即 顶级 数据 元 素 和 
RERA o 

在 第 3 章 中 曾 有 所 提 及 ， 顶 级 元 素 可 直接 声明 于 Kotlin 文件 中 ， 这 一 点 
ED 与 谋 套 于 类 、 对 象 、 接 口 和 函数 中 的 数据 元 素 有 所 不 同 。 在 Java 中 ， 可 在 顶 
级 仅 声 明 类 和 接口 ; 而 Kotlin 还 可 声明 函数 、 对 象 、 属 性 以 及 扩展 。 


下 面 首先 讨论 项 级 数据 元 素 的 可 见 修饰 符 。 

epublic〈 默 认 状态 ): 数据 元 素 于 各 处 均 处 于 可 见 状态 。 

e private: 数据 元 素 均 在 包含 声明 的 文件 内 部 处 于 可 见 状态 。 

e protected: 无 法 在 顶级 位 置 获取 。 

e internal: 数据 元 素 在 同一 模块 中 处 于 可 见 状态 。 也 就 是 说 ， 在 同一 模块 中 ， 针 对 数 
据 元 素 定义 为 public。 























什么 是 Java 和 Kotlin 中 的 模块 
€ 模块 是 指 共 同 参与 编译 的 Kotlin 文件 集合 ， 例 如 IntelliJ IDEA 模块 和 
Grade 项 目 。 应 用 程序 的 模块 化 结构 具备 较 好 的 发 布 机 制 ， 并 可 加 速 构建 过 
程 ， 其 原因 在 于 : 仅 重 新 编译 发 生变 化 的 模块 。 
相关 示例 如 下 所 示 : 


// top .kt 
public val version: String = "3.5.0" // 1 


internal class UnitConveter // 3 
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private fun printSomething() { 
println ("Something") 
} 


fun main(args: Array<String>) { 
println(version) // 1, Prints: "3.5.0" 
UnitConveter() // 2, Accessible 
printSomething() // 3, Prints: Something 
} 


// branch.kt 

fun main(args: Array<String>) { 
println(version) // 1, Accessible 
UnitConveter() // 2, Accessible 
printSomething() // 3, Error 

) 


// main.kt in another module 

fun main(args: Array<String>) ( 
println(version) // 1, Accessible 
UnitConveter() // 2, Error 
printSomething() // 3, Accessible 

) 


e 关于 注释 1，version 属性 定义 为 public， 因 而 在 全 部 文件 中 均 为 有 效 。 





susp 


e XT itf 2, UnitConveter 可 在 branch.kt 文件 中 予以 访问 。 虽 然 位 于 同一 模块 ， 但 











UnitConveter 并 未 处 于 main.kt 文件 中 ， 而 是 位 于 另 一 个 模块 中 。 
e 关于 注释 3，printSomething 函数 仅 在 其 所 定义 的 同一 文件 中 可 被 访问 。 
注意 ，Kotlin 中 的 包 并 不 会 产生 任何 额外 的 可 见 性 权限 。 





第 二 组 修饰 符 由 成 员 构成 ， 即 声明 于 项 级 元 素 内 部 的 数据 元 素 ， 一 般 是 方法 、 属 性 、 
构造 函数 、 对 象 〈 某 些 时 候 )、 伴 生 对 象 、getter 和 setter, (BAM RIEL TRE AAR 














。 相 关 规 则 如 下 。 

o public (默认 状态 ): 查看 声明 类 的 客户 端 可 看 到 public 成 员 。 
e private: 数据 元 素 仅 在 包含 该 成 员 的 类 或 接口 中 可 见 。 

e protected: 在 声明 类 和 子 类 中 可 见 ， 且 在 某 个 对 象 内 部 不 具备 可 用 性 。 
o internal: 模块 内 的 任意 客户 端 (查看 声明 类 ) 均 可 看 到 其 内 部 成 员 。 


























下 面 定义 顶级 数据 元 素 ， 该 示例 中 将 定义 一 个 类 ， 但 同一 逻辑 可 应 








Fa 





fo 











的 任意 顶级 数据 元 素 上 ， 如 下 所 示 : 


class Person ( 
public val name: String = "Igor" 


ri H 
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protected var age:Int = 23 
internal fun learn() {} 
private fun speak() {} 

H 


当 生 成 Person 类 实例 时 ， 仅 可 访问 标记 为 public 修饰 符 的 name 属性 ， 以 及 标记 为 internal 
修饰 符 的 learn 方法 ， 如 下 所 示 : 


// main.kt inside the same package as Person definition 
val person = Person() 








println (person.name) ge ih 
person. speak () // 2, Error 
person.age // 3, Error 
person.learn() //4 





e 对 于 注释 1， 访 问 Person 实例 的 客户 端 还 可 访问 name 属性 。 
e 对 于 注释 2，speak 方法 仅 在 Person 类 内 部 可 被 访问 。 
e 对 于 注释 3，age 属性 在 Person 类 及 其 子 类 中 可 被 访问 。 
e 针对 注释 4， 位 于 模块 内 部 且 访 问 Person 类 实例 的 客户 端 还 可 访问 其 public 成 员 。 
继承 可 访问 性 类 似 于 外 部 可 访问 性 ,二 者 间 的 主要 差别 在 于 , 标记 为 protected 修饰 符 
的 成 员 在 子 类 中 也 处 于 可 见 状态 ， 如 下 所 示 : 
open class Person { 
public val name: String = "Igor" 
private fun speak() () 


protected var age: Int - 23 
internal fun learn() () 




















) 


class Student() : Person() ( 
fun doSth() ( 
printin (name) 
learn() 
print (age) 
// speak() // 1 


} 
在 Student 子 类 中 , 可 访问 标记 为 public, protected, internal 的 成 员 , 但 不 包括 标记 为 private 
修饰 符 的 成 员 。 


public、private 和 protected 修饰 符 在 Java 中 均 包 含 对 等 的 修饰 符 ,但 并 不 包括 internal， 
而 不 支持 Java 中 的 字 节 码 。 这 也 是 internal 修饰 符 直 接 编 译 为 public 的 原因 。 当 与 其 通 
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信 时 将 无 法 在 Java 中 使 用 一 一 其 名 称 已 经 发 生变 化 ， 且 无 法 再 次 使 用 。 例 如 ， 当 定义 下 列 
Foo 类 时 : 
open class Foo { 


internal fun boo() ( ) 
} 


可 通过 Java 并 按照 如 下 方式 对 其 加 以 使 用 : 


public class Java { 
void a() { 
new Foo().boo$production sources for module SmallTest(); 


) 


具有 争议 的 是 ， 内 部 可 见 性 由 Kotlin 保护 ,并 可 以 通过 使 用 Java 适配器 
避 开 这 一 方式 ， 除 此 之 外 ， 不 存在 其 他 实现 方式 


除了 在 类 中 定义 可 见 性 修饰 符 之 外 ， 还 可 在 重 载 某 个 成 员 时 对 修饰 符 进行 重 载 ， 从 而 
可 弱化 继承 体系 结构 中 的 访问 限制 条 件 ， 如 下 所 示 : 
open class Person ( 


protected open fun speak() {} 
} 


class Student() : Person() { 
public override fun speak() { 


) 
) 


val person - Person() 
// person.speak() // 1 


val student = Student () 

student.speak() // 2 

e 针对 注释 1， 鉴 于 protected 特性 ， 无 法 访问 speak 方法 。 

e 针对 注释 2，speak 方法 的 可 见 性 调整 为 public， 因 而 可 对 其 进行 访问 。 

针对 成 员 及 其 可 见 性 范围 ， 修 饰 符 的 定义 方式 较为 直观 。 下 面 考察 类 和 构造 函数 可 见 
性 的 定义 方式 。 如 前 所 述 ， 主 构造 函数 定义 位 于 类 头 部 位 置 ， 因 而 一 行 代码 中 需要 定义 两 
个 可 见 性 修饰 符 ， 如 下 所 示 : 


internal class Fruit private constructor { 
var weight: Double? = null 
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companion object ( 
fun create() = Fruit() 
} 
} 


假设 上 述 类 定义 在 顶部 (顶级 )， 因 而 在 当前 模块 内 可 见 ， 但 仅 可 从 包含 类 声明 的 文件 中 
予以 实例 化 ， 如 下 所 示 : 
var fruit: Fruit? = null // Accessible 
fruit - Fruit() // Error 
fruit = Fruit.create()  // Accessible 
默认 条 件 下 ，getter 和 setter 与 属性 具有 相同 的 可 见 性 修饰 符 ， 但 也 可 对 其 进行 修改 。 
相应 地 ，Kotlin 可 在 get/set 关键 字 之 前 设置 可 见 性 修饰 符 ， 如 下 所 示 ; 
class Car ( 
init ( 
count++; 
println("Car created") 














) 


companion object ( 
init ( 
println("Car companion object created") 
) 
var count: Int - 0 
private set 


) 
在 上 述 示例 中 ，getter 的 可 见 性 已 被 调整 。 需 要 注意 的 是 ， 该 方案 可 在 不 改变 〈 编 译 器 生 
成 的 ) 默认 实现 的 前 提 下 修改 可 见 性 修饰 符 。 作 为 只 读 型 外 部 客户 端 ， 实 例 计数 器 当前 处 
于 安全 状态 ， 但 仍 可 从 Car 类 内 部 调整 属性 。 








414 密 封 类 





密封 类 包含 了 有 限 数 量 的 子 类 密封 的 子 类 型 层次 结构 )。 在 Kotlin 1.1 之 前 ， 子 类 须 
在 密封 类 体 中 定义 。 Kotlin 1.1 弱化 了 这 一 限制 条 件 , 并 可 作为 密封 类 声明 在 同一 文件 中 定 
义 密封 类 子 类 。 其 中 ， 全 部 类 均 彼 此 靠近 而 声明 ， 因 而 可 简单 地 查看 一 个 文件 ， 即 可 方便 
也 看 到 全 部 子 类 ， 如 下 所 示 : 
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// vehicle.kt 


sealed class Vehicle() 
class Car : Vehicle() 
class Truck : Vehicle() 
class Bus : Vehicle() 


当 标记 密封 类 时 ， 可 向 类 声明 添加 sealed 修饰 符 。 上 述 声 明 表 示 ，Vehicle 类 仅 可 通过 
3 个 类 被 扩展 ， 即 Car. Truck 以 及 Bus 类 ， 且 全 部 声明 于 同一 个 文件 中 。 除 此 之 外 ， 还 可 
在 vehicle.kt 文件 中 添加 第 4 个 类 ， 但 却 无 法 在 另 一 个 文件 中 定义 该 类 。 

密封 子 类 型 限制 仅 适用 于 Vehicle 类 的 直接 继承 者 ， 这 意味 着 ，Vehicle 仅 可 被 定义 于 
相同 文件 中 的 类 扩展 (Car、Truck 或 Bus)。 假 设 Car. Truck 或 Bus 类 处 于 open 状态 ， 随 
后 可 通过 声明 于 任意 文件 内 部 的 某 个 类 进行 扩展 ， 如 下 所 示 : 

// vehicle.kt 


sealed class Vehicle() 
open class Bus : Vehicle() 




















// data.kt 
class SchoolBus:Bus() 
为 了 避免 这 一 行为 ， 需 要 将 Car. Truck 或 Bus 标记 为 sealed， 如 下 所 示 : 


// vehicle.kt 
Sealed class Vehicle() 
Sealed class Bus : Vehicle() 


// data.kt 
class SchoolBus:Bus() // Error cannot access Bus 


密封 类 可 与 when 表达 式 实现 良好 的 协同 工作 。 由 于 编译 器 可 验证 : 密封 类 的 各 个 子 类 在 
when 代码 块 中 包含 对 应 的 子 句 ， 因 而 无 须 设置 else 子 句 ， 如 下 所 示 : 
when (vehicle) { 
is Car -> println("Can transport 4 people") 
is Truck -» println("Can transport furnitures ") 


is Bus -» println("Can transport 50 people ") 
} 


此 处 可 安全 地 向 Vehicle 类 添加 新 的 子 类 一 一 如 果 在 程序 某 处 缺失 对 应 的 when KERT 
句 ， 该 程序 将 无 法 编译 。 这 也 修复 了 Java 中 的 switch 语句 ， 其 中 ， 程 序 员 往 往 会 忘记 添 
加 相关 内 容 ， 这 将 导致 程序 崩溃 ， 或 者 产生 未 知 错误 。 

默认 状态 下 ， 密 封 类 为 抽象 类 ， 因 而 无 须 添 加 abstract 修饰 符 。 另 外 ， 密 封 类 不 可 定 
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XU open 或 final 状态 。 同 时 ， 当 需要 确保 仅 存在 单一 实例 时 ， 可 利用 对 象 蔡 换 子 类 ， 如 
TB: 


Sealed class Employee() 








class Programmer : Employee() 
class Manager : Employee() 
object CEO : Employee() 
上 述 声 明 不 仅 保护 了 继承 层次 结构 ， 同 时 还 将 CEO 限定 为 单一 实例 。 关 于 密封 类 ， 更 为 
详细 的 讨论 已 超出 了 本 书 的 范围 ， 但 读者 须 注意 以 下 几 点 内 容 : 
e 定义 诸如 链表 或 二 叉 树 数据 类 型 〈 读 者 可 参考 https://en.wikipedia.org/wiki/Algebraic_ 
data type). 
e 当 构 造 应 用 程序 模块 或 库 时 ， 若 不 允许 客户 端 扩展 类 ， 但 依然 可 亲自 对 其 进行 扩展 
时 ， 应 保护 继承 层次 结构 。 
。 在 状态 机 中 ， 某 些 状态 可 能 会 包含 其 他 状态 中 的 无 意义 数据 (参考 https://en. 
wikipedia. org/ wiki/Finite- state machine). 


。 词 法 分 析 中 的 标记 类 型 列表 。 
415 说 套 X 


嵌 套 类 表示 为 定义 于 另 一 个 类 中 的 数据 类 。 在 顶级 类 中 嵌 套 小 型 数据 类 可 将 代码 置 于 
所 用 附近 处 ， 并 以 较 好 的 方式 对 类 进行 组 织 。 对 此 ， 典 型 的 示例 是 Tree/Leaf 监听 器 或 状 
SRR. KWF Java, Kotlin 也 可 定义 嵌 套 类 ， 并 存在 两 种 处 理 方式 。 例 如 ， 可 将 类 作为 
成 员 在 某 个 类 中 加 以 定义 ， 如 下 所 示 : 


class Outer ( 
private val bar: Int = 1 















































class Nested ( 
fun foo() = 2 
} 
5 


val demo = Outer.Nested().foo() // == 2 
上 述 示例 可 生成 Nested 类 实例 ， 且 无 须 创 建 Outer 类 实例 。 其 中 ， 类 无 法 直接 引用 实例 变 
量 或 定义 于 其 封闭 类 中 的 相关 方法 〈 仅 可 通过 对 象 引用 加 以 使 用 )。 这 等 价 于 Java 中 的 静 
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当 访 问 外 部 类 的 成 员 时 ， 需 要 将 嵌 套 类 标记 为 inner， 进 而 创建 第 二 类 数据 类 ， 
TB: 


class Outer ( 
private val bar: Int = 1 


inner class Inner ( 
fun foo() = bar 
) 
$ 


val outer = Outer () 
val demo = outer.Inner().foo() // = 1 


如 


当 实例 化 inner 类 时 ， 首 先 需 要 实例 化 Outer 类 。 此 处 ，Inner 类 可 访问 定义 于 外 部 类 
中 的 全 部 方法 和 属性 ， 并 与 外 部 类 共享 状态 ， 每 个 Outer 类 中 仅 可 存在 单一 的 Inner 类 实 








例 。 表 4.5 总 结 了 其 中 的 差异 。 


表 4.5 
fiu 内 部 类 (成员) 

类 似 于 Java 中 的 静态 成 员 否 

该 类 实例 可 在 缺少 封闭 类 实例 情况 下 存在 5 
包含 外 部 类 的 引用 是 

与 外 部 类 共享 状态 (可 访问 外 部 类 成 员 ) 是 

每 个 外 部 类 实例 包含 
实例 的 数量 无 限制 enc 





当 决 定 是 否定 义 inner 类 或 顶级 类 时 ， 应 考察 潜在 的 类 应 用 方式 。 如 果 类 仅 对 单一 类 
实例 有 效 ， 则 应 将 其 声明 为 inner; 如 果 与 外 部 类 相 比 ， 内 部 类 在 男 一 个 上 下 文 环境 中 更 为 











有 效 ， 则 须 将 其 声明 为 顶级 类 。 
416 导入 别名 


别名 是 一 种 新 的 类 型 名 称 引入 方式 。 如 果 类 型 名 称 已 用 于 某 个 文件 中 ， 但 该 名 称 可 能 
不 太 适 宜 或 者 较 长 ， 对 此 ， 可 引入 不 同 的 名 称 加 以 使 用 ， 而 不 再 使 用 原 类 型 名 称 。 注 意 ， 














别名 并 未 引入 新 的 类 型 ， 且 仅 在 编译 期 之 前 有 效 (编写 代 码 时 )。 最 终 ， 编 译 器 将 利 


13. 








际 类 蔡 换 类 别名 ， 因 而 别名 在 运行 期 内 不 复 存在 。 
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某 些 时 候 ， 需 要 在 单一 文件 中 使 用 包含 相同 名 称 的 多 个 类 。 例 如 ，InterstitialAd 类 型 
分 别 定义 于 Facebook 和 Google 广告 库 中 , 假设 在 某 个 单一 文件 中 均 需 要 使 用 到 这 两 个 库 。 
这 在 项 目 开发 中 较为 常见 ， 以 在 两 个 广告 供应 商 之 间 实 现 效 益 对 比 。 此 处 的 问题 是 ， 在 单 

文件 中 使 用 两 种 数据 类 型 则 意味 着 ， 须 通过 完全 限定 类 名 (命名 空间 + 类 名 ) 对 其 进行 
访问 ， 如 下 所 示 : 


import com.facebook.ads.InterstitialAd 





















































val fbAd - InterstitialAd(context, "...") 
val googleAd = com.google.android.gms.ads.InterstitialAd (context) 


限定 类 名 和 非 限定 类 名 
非 限 定 类 名 简单 地 表示 为 类 名 ， 例 如 Box; 而 限定 类 名 则 表示 为 命名 空 
间 和 类 名 的 结合 体 ， 例 如 com.test.Box。 


在 这 一 类 使 用 环境 中 ， 可 能 有 人 认为 较 好 的 做 法 是 重 命名 某 个 类 。 但 某 些 场合 下 ， 该 
方法 并 不 可 行 〈 对 应 类 定义 于 外 部 库 中 )， 或 者 并 非 是 一 种 期 望 行为 《类 名 与 后 台数 据 库 
表 保 持 一 致 )。 对 此 ， 上 述 两 个 类 均 位 于 外 部 库 中 ， 类 命名 冲突 的 解决 方法 是 使 用 import 
别名 。 相 应 地 ， 可 将 Google InterstitialAd 重 命 名 为 GoogleAd， 并 将 Facebook InterstitialAd 
重 命名 为 FPAd， 如 下 所 示 : 

import com.facebook.ads.InterstitialAd as FbAd 

import com.google.android.gms.ads.InterstitialAd as GoogleAd 
当前 ， 可 像 实际 类 型 那样 针对 文件 使 用 别名 ， 如 下 所 示 : 

val fbAd = FbAd(context, "...") 

val googleAd = GoogleAd (context) 

通过 import 别名 ， 可 显 式 地 重 定义 导入 至 某 一 文件 中 的 类 名 。 在 这 种 情况 下 ， 无 须 使 
两 个 别名 ， 但 这 将 会 提升 代码 的 可 读 性 一 一 与 InterstitialAd 和 GoogleAd 相 比 ， 较 好 的 
方法 是 设置 FbAd 和 GoogleAd。 由 于 可 简单 地 告知 编译 器 : 每 次 遇 到 GoogleAd 别名 时 ， 
可 在 编译 过 程 中 将 其 转换 为 com.google.android.gms.ads.InterstitialAd; 每 次 遇 到 FbAdalias 
时 可 将 其 转换 为 com.facebook.ads.InterstitialAd， 因 而 无 须 再 使 用 完全 限定 类 名 。 另 外 ， 导 
入 birmingham 仅 工作 于 别名 所 定义 的 文件 内 。 


417 本 章 小 结 






























































本 章 讨论 了 针对 面向 对 象 程序 设计 的 构造 块 ， 如 何 定义 接口 、 类 以 及 inner、sealed、 
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enum 和 数据 类 之 间 的 差异 。 其 中 ， 全 部 元 素 在 默认 条 件 下 均 为 public 类 型 ， 且 全 部 类 / 接 
均 为 final 类 型 〈 默 认 状 态 下 )， 因 而 需要 显 式 地 执行 “开启 ”操作 ， 进 而 支持 继承 和 成 
员 重 载 机 制 。 

本 章 还 介绍 了 如 何 通过 简明 的 数据 类 (与 功能 强大 的 属性 相 结合 ) 定义 相应 的 数据 模 
块 ， 如何 利 用 编译 器 生成 的 方法 对 数据 进行 操作 ， 以 及 如 何 重 载 操作 符 。 

另外 ， 本 章 还 探讨 了 如 何 通过 对 象 声 明生 成 单 例 ， 如 何 定 义 匿名 类 型 对 象 ， 并 以 此 通 
过 对 象 表达 式 扩展 某 些 类 和 /或 实现 某 些 接口 。 除 此 之 外 ， 本 章 还 展示 了 lateinit 修饰 符 的 
具体 应 用 ， 进 而 利用 延迟 初始 化 行为 定义 非 空 数据 类 型 。 

第 5 章 将 考察 Kotlin 中 的 函数 ， 并 讨论 与 函数 式 编程 EFP) 相关 的 概念 ， 包 括 函数 类 
型 、lambdas 以 及 高 阶 函 数 。 
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第 4 章 介绍 了 Kotlin 中 与 OOP 相关 的 特性 。 本 章 则 主要 讨论 之 前 标准 Android 开发 
中 未 涉及 的 高 级 函数 特性 。 其 中 ， 某 些 特性 在 Java 8 中 被 引入 (在 Android 中 通过 
Retrolambda 插件 )， 但 Kotlin 中 涵盖 了 大 量 的 函数 编程 特性 。 

本 章 主要 介绍 高 级 函数 ， 并 将 其 视 为 “一 等 公民 ”。 大 多 数 概念 与 读者 之 前 所 见 的 函 
数 型 语言 并 无 太 多 差异 。 

本 章 主要 涉及 以 下 内 容 : 

e 函数 类 型 。 

e 匿名 函数 。 

e Lambda 表达 式 。 

eLambda 表达 式 中 独立 参数 的 隐 式 名 称 。 

e 高 阶 函数 。 

e 人 参数 规则 中 最 后 一 个 Lambda. 

e Java 单一 抽象 方法 (SAM) 接口 。 

e 参数 应 用 中 ， 基 于 Java 单一 抽象 方法 的 Java 方法 。 



































e 函数 类 型 中 的 命名 参数 。 
e 类 型 别名 。 
e 内 联 函 数 。 
e 函数 引用 。 





51 函数 类 型 





Kotlin 支持 函数 编程 ， 在 Kotlin 中 ， 函 数 被 视 为 “一 等 公民 ”。 在 现 有 的 编程 语言 中 ， 
术语 “一 等 公民 ”描述 了 一 类 实体 ， 并 支持 其 他 实体 中 可 用 的 全 部 操作 。 此 类 操作 一 般 包 
括 参数 传递 、 函 数 中 的 返回 机 制 以 及 变量 赋值 。 因 此 ,“Kotlin 中 函数 视 作 一 等 公民 ”应 该 
理解 为 : Æ Kotlin 中 ， 可 作为 参数 传递 函数 ， 可 从 函数 中 返回 函数 ; 将 函数 赋予 某 个 变量 
中 。 虽 然 Kotlin 是 一 类 静态 类 型 语言 ， 但 仍 须 定义 某 种 函数 类 型 ， 以 支持 各 项 操作 。 在 
Kotlin 中 ， 定 义 函数 类 型 的 符号 如 下 所 示 : 

(types of parameters)->return type 


相关 示例 如 下 所 示 : 
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e (Int) ->Int: 函数 接收 Int 作为 参数 ， 并 返回 Int. 
e () ->Int: 函数 未 接收 任何 参数 ， 并 返回 Int. 
e (Int)-»Unit: 函数 接收 Int 参数 ， 且 不 返回 任何 内 容 〈 仅 为 Unit， 且 无 须 返回 ) 。 


下 列 内 容 显示 了 可 载 入 函数 的 属性 示例 : 





lateinit var a: (Int) -> Int 
lateinit var b: ()-»Int 
lateinit var c: (String)-»Unit 


术语 “函数 类 型 ”通常 定义 为 赋予 函数 的 变量 或 参数 类 型 ， 或 者 是 接收 
b KOLA DAM, BERE ACXLAEAUM. A Kotin P, AKAT 
像 接口 那样 被 处 理 。 


本 章 后 续 内 容 将 会 看 到 ，Kotlin 函数 可 在 参数 中 使 用 其 他 函数 ， 甚 至 可 返回 函数 ， 如 
下 所 示 : 
fun addCache(function: (Int) -> Int): (Int) -> Int ( 


// code 
) 


val fibonacciNumber: (Int)-»Int = // function implementation 

val fibonacciNumberWithCache = addCache (fibonacciNumber) 

如 果 某 个 函数 可 接收 或 返回 函数 ， 那 么 ， 该 函数 类 型 应 能 够 定义 相关 函数 ， 并 以 参数 
形式 接收 函数 ， 或 者 返回 某 个 函数 。 对 此 ， 可 简单 地 将 函数 类 型 符号 定义 为 一 个 参数 或 返 
回 类 型 。 相 关 示 例如 下 所 示 。 

e (String)-»(Int)-»Int: 函数 接收 string, 并 返回 一 个 函数 (接收 Int 类 型 并 返回 Int). 

© (()-»Int)-»String: 函数 接收 另 一 个 函数 作为 参数 ， 并 返回 String 类 型 。 其中, 参数 中 的 

函数 并 不 接收 任何 参数 ， 且 返回 Int。 

基于 函数 的 各 项 属性 可 像 某 个 函数 那样 被 调用 ， 如 下 所 示 


val i = a(10) 
val j = b() 
c("Some String") 


函数 不 仅 可 存储 于 变量 中 ,还 可 用 作 泛 型 。 例 如 , 可 将 函数 保存 至 列表 中 ， 如 下 所 示 : 


var todobist: List<() -> Unit» = // ..: 
for (task in todoList) task() 


上 述 列表 可 存储 包含 0 -> Unit 签名 的 函数 。 
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实际 上 ， 函 数 类 型 仅 表示 为 针对 通用 接口 的 一 类 语法 糖 。 下 面 考察 某 些 示 例 : 


e ()->Unit 签名 表示 为 针对 Function0<Unit> 的 一 个 接口 。 由 于 包含 了 0 个 参数 ， 因 而 表达 
式 为 Function0， 且 返回 类 型 为 Uint。 

e (Int)->Unit 签名 表示 为 针对 Function1<Int, Unit> 的 接口 。 由 于 包含 了 1 个 参数 ， 因 而 
表达 式 为 Function1。 
e ()-»(Int, Int)->String 签名 表示 针对 Function0<Function2<Int, Int, String>> 
的 接口 。 


上 述 接口 仅 包含 一 个 方法 invoke， 同 时 表示 为 一 个 操作 符 ， 并 支持 某 个 对 象 可 像 函 数 那样 
加 以 使 用 ， 如 下 所 示 : 
val a: (Int) -» Unit - //... 


a(10) Ji at 
a.invoke(10)// 1 


针对 注释 1， 两 条 语句 具有 相同 的 含义 。 

函数 接口 并 未 在 标准 库 中 体现 ， 并 可 视 作 整合 后 的 、 编 译 器 生成 的 类 型 〈 在 编译 期 
间 生 成 )。 据 此 ， 在 函数 类 型 参数 的 数量 上 并 不 存在 人 为 的 限制 ， 且 标准 库 的 尺寸 也 不 会 
增加 。 
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一 种 将 函数 定义 为 对 象 的 方式 是 使 用 匿名 函数 ， 其 工作 方式 与 常规 函数 相同 ， 但 在 
fun 关键 字 和 参数 声明 之 间 并 不 包含 名 称 。 因 此 ,默认 条 件 下 将 被 视 为 对 象 。 对 应 示例 如 
下 所 示 : 

val az int) -> Int = fun: rnb) = 1*2 7/750 

val b: ()->Int = fun(): Int { return 4 } 

val c: (String)->Unit = fun(s: String){ println(s) } 

对 于 注释 1， 代 码 表示 为 匿名 单一 表达 式 函数 。 需 要 注意 的 是 ， 类 似 于 常规 独立 表达 式 函 
数 ， 当 从 表达 式 返 回 类 型 进行 推断 时 ， 返 回 类 型 无 须 被 指定 。 

















考察 下 列 应 用 示例 : 

// Usage 

println(a(10)) // Prints: 20 
println(b()) // Prints: 4 

c("Kotlin rules")  // Prints: Kotlin rules 








在 上 述 示例 中 , 函数 类 型 采用 显 式 方式 加 以 定义 ; 而 Kotlin 中 包含 了 较 好 的 类 型 推断 机 制 ， 
函数 类 型 可 从 匿名 默认 函数 定义 的 类 型 进行 推断 ， 如 下 所 示 : 
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vara = funmi: mE = 

var b = fun(): Int { return 4 } 

var c = fun(s: String){ println(s) } 
除 此 之 外 ， 还 可 按照 相反 的 方式 工作 。 当 定义 某 个 属性 的 类 型 时 ， 考 虑 到 推断 机 制 ， 无 须 
在 匿名 函数 中 显 式 地 设置 参数 类 型 ， 如 下 所 示 : 

var a: (Int)->Int = fun(i) = i * 2 

var c: (String)-»Unit = fun(s){ println(s) } 

当 检 测 函数 类 型 的 方法 时 ， 将 会 看 到 其 中 仅 存在 invoke 方法 。 这 里 ，invoke 方法 定义 
为 一 个 操作 符 函 数 ， 其 应 用 方式 与 函数 调用 相同 。 因 此 ,在 括号 内 使 用 invoke 调用 将 得 到 
相同 的 结果 ， 如 下 所 示 : 

println(a.invoke (4)) // Prints: 8 


println (b.invoke()) // Prints: 4 
c.invoke("Hello, World!") // Prints: Hello, World! 


这 一 点 十 分 重要 ， 例 如 在 某 个 可 空 变量 中 设置 函数 时 。 对 此 ， 可 通过 安全 调用 使 用 
invoke 方法 ， 如 下 所 示 : 

var a: ((Int) -> Int)? = null // 1 

if (false) a = fun(i: Int) =i * 2 

print(a?.invoke(4)) // Prints: null 
在 注释 1 中 ，a 可 空 ， 因 而 通过 安全 调用 使 用 invoke 方法 。 

下 面 考察 一 个 Android 示例 。 通 常情 况 下 ， 需 要 定义 一 个 独立 的 错误 处 理 程序 ， 典 
包含 了 多 个 日 志方 法 ， 并 作为 参数 将 其 传递 至 不 同 的 对 象 中 。 下 列 代码 展示 了 如 何 通 过 匿 
名 函数 对 其 加 以 实现 。 

val TAG = "MainActivity" 

val errorHandler - fun (error: Throwable) ( 


if(BuildConfig.DEBUG) ( 
Log.e(TAG, error.message, error) 

























































































Pa E 





} 
toast (error.message) 
// Other methods, like: Crashlytics.logException (error) 


} 


// Usage in project 
val adController = AdController (errorHandler) 
val presenter - MainPresenter (errorHandler) 
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// Usage 
val error = Error("ExampleError") 
errorHandler(error) // Logs: MainActivity: ExampleError 


匿名 函数 简单 而 有 效 ， 并 可 定义 函数 以 作为 对 象 加 以 使 用 和 传递 。 除 此 之 外 ， 还 存在 





更 为 简单 的 方式 可 实现 类 似 的 行为 ， 即 Lambda 表达 式 。 


53 Lambda 表达 式 


在 Kotlin 中 , 最 为 简单 的 匿名 函数 定义 方式 是 使 用 Lambda 表达 式 。 该 表达 式 与 Java 8 





中 的 Lambda 表达 式 类 似 , 二 者 间 的 主要 差别 在 于 , Kotlin 中 的 Lambda 表达 式 实际 上 为 闭 


包 ， 





因而 可 根据 构建 上 下 文 修改 变量 。 这 在 Java 8 中 并 不 可 行 ， 本 章 稍 后 将 探讨 其 中 的 差 














异 。 


Hy 








下 面 考察 一 些 简单 的 示例 。Kotlin 中 的 Lambda 表达 式 包含 下 列 符号 : 











{ arguments -> function body } 


Ph， 将 返回 最 后 一 个 表达 式 的 结果 。 下 面 是 一 些 简单 的 Lambda 表达 式 示例 。 























e ( 1 }: iX Lambda 表达 式 不 包含 任何 参数 并 返回 1， 其 类 型 为 () ->Int。 

e ( s: String -> println(s) ): 该 Lambda 表达 式 接收 类 型 为 String 的 1 个 参数 并 对 
其 予以 和 输出， 同时 返回 Unit， 对 应 类 型 为 (String) ->Unit。 

e (a: Int, b: Int -> a + b }: iZ Lambda 表达 式 接收 两 个 Int 参数 ， 并 返回 二 者 之 和 ， 

对 应 类 型 为 (Tnt， Int)-»Int. 


在 第 3 章 中 ， 所 定义 的 函数 可 采用 Lambda 表达 式 加 以 定义 ， 如 下 所 示 : 


war as dine) -> Int = f is dnb -5 4*2 
war De ()->int = { 4} 
var c: (String)->Unit = ( s: String -> println(s) } 


返回 类 型 源 自 Lambda 表达 式 中 的 最 后 一 条 语句 ,但 除非 包含 了 某 个 标记 限定 的 retum 






































语句 ， 和 否则 ， 返 回 操作 行为 并 不 被 允许 ， 如 下 所 示 : 





var a: (Int) -» Int = { i: Int -» return i * 2 } 
// Error: Return is not allowed there 
var 1: (Int) -> Int = 18 ( i: Int -> return@l i * 2 } 


FAs, Lambda 还 可 包含 多 行内 容 ， 如 下 所 示 : 


val printAndReturn = { i: Int, j: Int -> 
println("I calculate $i + $j") 
mec ef 
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针对 注释 1， 该 语句 为 最 后 一 条 语句 ， 因 而 该 表达 式 的 结果 将 表示 为 返回 值 。 
当 采 用 分 号 进行 分 割 时 ， 多 行 语句 也 可 在 一 行 中 加 以 定义 ， 如 下 所 示 : 


val printAndReturn = (i: Int, j: Int -> println("I calculate $i + $j"); 





Lambda 表达 式 不 仅 可 在 参数 提供 的 数值 上 进行 操作 ， 还 可 根据 构建 上 下 文 使 有 





属性 和 函数 ， 如 下 所 示 : 


n 








NONE A MN 




















wal text = "Text" 

var a: () -> Unit = { println(text) } 
a() // Prints: Text 

a() // Prints: Text 


这 也 是 Kotlin 和 Java 8 之 间 的 最 大 差异 。Java 匿名 对 象 和 Java 8 Lambda 表达 式 可 使 


自 上 下 文中 的 字段 ， 但 


45 。 


全 部 

















Java 并 不 允许 向 此 类 变量 赋予 不 同 的 值 〈( 用 于 Lambda 中 的 








变量 须 为 fnal， 如 图 5.1 所 示 )。 


import kotlin.jvm.functions.Function@; 


public class JavaTest { 


public static void main(String[] args) { 
int counter = 0; 
Function@<Void> func = () -> { 
Mt; 
m mmm Maid TVDEs 
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6 ef 
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1$ cC 
11 } 
12 | 


Variable used in lambda expression should be final or effectively final 





F 








E 5.1 


Kotlin 在 这 一 方面 则 更 胜 一 筹 : Lambda 表达 式 和 匿名 函数 可 修改 上 述 值 。 封装 了 
变量 并 可 在 函数 体内 对 其 进行 修改 的 Lambda 表达 式 称 作 闭 包 。Kotlin 支持 完整 的 闭 包 定 








义 。 为 了 避免 Lambda f 


vari-1 
val a: () -> Int 





= { ++i } 


println (i) // Prints: 
println (a()) // Prints: 


println (i) 
printin (a()) 
println (i) 


Lambda 表达 式 可 月 


1 
2 
cf Prints: 2 
H Prints: 3 
AL Printsi 3 








例 ， 其 中 ， 对 应 数值 保存 于 局 部 变量 中 ， 如 下 所 示 : 


1 闭 包 之 间 的 混淆 ， 本 书 将 二 者 统称 为 Lambda。 考 察 下 列 示 例 : 





iD 


Java 


局 部 





目 于 修改 局 部 上 下 文 环境 中 的 变量 ， 下 列 代码 展示 了 一 个 计数 器 示 
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fun setUpCounter() ( 
var value: Int = 0 
val showValue = { counterView.text = "$value" } 
counterIncView.setOnClickListener { value++; showValue() } 
Vi E 
counterDecView.setOnClickListener { value--; showValue() } 
ZA 

) 


针对 注释 1， 通 过 Lambda 表达 式 可 在 Kotlin 中 设置 View 的 onClickListener。 

需要 注意 的 是 ， 在 上 述 示例 中 ， 并 未 指定 showValue 类 型 ， 其 原因 在 于 : 在 Kotlin 的 
Lambda 表达 式 中 ， 若 编译 器 可 从 上 下 文中 进行 推断 时 ， 类 型 参数 为 可 选 类 型 ， 如 下 所 示 : 

wal as (int) => mE =) => ONT 

val c: (String)->Unit = ( s -> println(s) ) // 2 
针对 注释 1，i 的 推断 类 型 为 Int 一 一 该 函数 类 型 定义 为 Int 参数 ， 对 于 注释 2，s 的 推断 类 
型 表示 为 String 一 一 函数 类 型 定义 为 String 参数 。 

在 后 续 示 例 中 将 会 看 到 ， 由 于 可 根据 属性 类 型 进行 推断 ， 因 而 无 须 指定 参数 类 型 ， 除 
此 之 外 ， 类 型 推断 还 可 以 另 一 种 方式 工作 : 可 定义 Lambda 表达 式 参 数 的 类 型 ， 进 而 推断 
属性 类 型 ， 如 下 所 示 ; 


























yar tess Ty Al ff WAL 
val c = ( s: String -> println(s) } W Z 
valas i SS Geh ES. 





针对 注释 1, 由 于 4 为 Int 且 不 存在 参数 类 型 ， 因 而 推断 类 型 为 ype is ()->Int。 对 于 注释 2, 
由 于 参数 类 型 为 Sting, A println 方法 的 返回 类 型 表示 为 Unit， 因 而 推断 类 型 为 
(String)->Unit。 对 于 注释 3， 由 于 i 为 mt， 且 Int 的 乘法 运算 操作 的 返回 类 型 为 Int， 因 而 
推断 类 型 为 (nb->Int。 

该 推断 简化 了 Lambda 表达 式 的 定义 。 通 常情 况 下 ， 当 把 Lambda 表达 式 定义 为 函数 
参数 时 ， 无 须 每 次 指定 参数 类 型 。 除 此 之 外 ， 当 参数 类 型 可 被 推断 时 ， 可 针对 单一 参数 
Lambda 表达 式 使 用 更 为 简单 的 标记 ， 稍 后 将 对 此 加 以 讨论 。 
当 满 足下 列 两 个 条 件 时 ， 可 忽略 Lambda 参数 定义 ， 并 使 用 站 关键 字 访问 参数 : 

e 仅 存 在 一 个 参数 。 

e 参数 类 型 可 根据 上 下 文 进行 推断 。 

作为 示例 ， 下 面 再 次 定义 属性 a 和 c， 但 使 用 单一 参数 的 隐 式 名 称 ， 如 下 所 示 : 


val az: (Int) => Int = { it * 2 } 
val c: (String)-»Unit = { println(it) } 
































针对 注释 1， 代 码 等 同 于 {i-> i* 2 }; 针对 注释 2， 代 码 等 同 于 


上 述 符号 在 Kotlin 4 
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十 分 常见 ， 其 优点 体现 在 短小 精 悍 ， 





此 之 外 ， 还 提升 了 定义 于 LINQ 风格 中 处 理 过 程 的 可 读 性 。 该 
引入 的 组 件 ， 此 处 仅 为 展示 这 一 概念 。 考 察 下 列 示 例 : 


strings.filter { it.length = 5 }.map { it.toUpperCase() ) 


其 中 , 假设 字符 串 表 示 为 List<String>， 该 表达 式 利用 “长 度 等 于 5” 这 一 条 件 过 滤 字符 号 








并 将 其 转换 为 大 写 形式 。 
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F { s -> println(s) }。 














风格 需要 使 

















同时 还 可 避免 参数 定义 。 除 


到 某 些 尚未 被 





p 








需要 注意 的 是 , 在 Lambda 表达 式 体 中 ， 可 使 用 String 类 中 的 相关 方法 ， 其 原因 在 于 : 
函数 类 型 (例如 针对 filter 的 (String)->Boolean) 根据 当前 方法 定义 进行 推断 ， 即 根据 可 从 


代 类 型 (List<String>) 推断 String。 另 外 ， 返 回 


(String) 返回 的 内 容 。 


LINQ 风格 在 函数 式 语言 中 较为 常见 ， 并 使 得 








洁 。 第 7 章 将 对 此 加 以 深入 介绍 。 


高 阶 函 数 是 指 ， 函 数 至 少 接收 一 个 函数 作为 参数 ， 或 者 返 
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列表 类 型 (List<String>) 取决 于 Lambda 


合 语法 或 者 String 的 处 理 过 程 更 为 简 


回 一 个 函数 作为 最 终结 果 。 


Kotlin 对 此 提供 了 完整 的 支持 。 此 处 假设 需要 定义 两 个 函数 ， 函 数 一 将 从 列表 中 添加 全 部 
BigDecimal 数字 ; 函数 二 将 获取 全 部 数字 的 乘积 结果 列表 中 全 部 元 素 间 的 乘法 运算 结 


果 )， 如 下 所 示 : 


fun sum(numbers: 


List«BigDecimal»): BigDecimal ( 


var sum = BigDecimal.ZERO 
for (num in numbers) ( 
sum += num 


} 
return sum 


) 





fun prod(numbers: List«BigDecimal»): BigDecimal ( 
var prod - BigDecimal.ONE 
for (num in numbers) ( 
prod *- num 


} 
return prod 
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// Usage 

val numbers = listOf( 
BigDecimal.TEN, 
BigDecimal.ONE, 
BigDecimal.valueOf (2) 

) 


print (numbers) //[10, 1, 2] 
println(prod(numbers))  // 20 
println (sum (numbers) ) LIENS 


上 述 函 数 基本 相同 ， 唯 一 的 差别 在 于 名 称 、 累 加 器 CBigDecimal ZERO BÈ BigDecimal. ONE) 
以 及 相关 操作 。 当 采用 DRY (不 要 重复 自己 ) 规则 时 ， 则 不 应 保留 项 目 中 的 两 部 分 类 似 代 
码 。 昌 然 定 义 一 个 具有 相似 行为 ， 但 在 使 用 的 对 象 中 却 有 不 同 的 函数 很 容易 ， 相 比 之 下 ， 
定义 一 个 执行 操作 中 有 所 差异 的 函数 却 较为 困难 〈 此 处 ， 函 数 的 差异 体现 在 累积 过 程 中 的 
相关 操作 )。 由 于 可 将 当前 操作 作为 参数 加 以 传递 ， 因 而 函数 类 型 可 视 为 一 种 解决 方案 。 
在 该 示例 中 ， 可 通过 下 列 方 式 获取 常用 方法 : 
fun sum(numbers: List<BigDecimal>) = 
fold(numbers, BigDecimal.ZERO) ( acc, num -> acc + num ) 


























fun prod(numbers: List<BigDecimal>) = 
fold(numbers, BigDecimal.ONE) { acc, num -> acc * num ] 


private fun fold( 
numbers: List<BigDecimal>, 
start: BigDecimal, 
accumulator: (BigDecimal, BigDecimal) -> BigDecimal 
): BigDecimal ( 
var acc = start 
for (num in numbers) ( 
acc = accumulator(acc, num) 
} 
return acc 
} 


// Usage 


fun BD(i: Long) = BigDecimal.valueOf (i) 

val numbers = listOf(BD(1), BD(2), BD(3), BD(4)) 
println(sum(numbers))  // Prints: 10 
printin(prod(numbers)) // Prints: 24 
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其 中 ，fold 函数 遍历 数字 ， 并 利用 各 项 元 素 更 新 acc。 需 要 注意 的 是 ， 函 数 参 数 的 定义 类 
似 于 其 他 类 型 ， 并 可 像 其 他 函数 那样 加 以 使 用 。 例 如 ， 可 定义 vararg 函数 类 型 参数 ， 如 下 
所 示 : 

fun longOperation (vararg observers: ()->Unit) { 


[eee 
for(o in observers) o() 





2; 
在 longOperation 中 ，for 用 于 遍历 全 部 观察 者 ， 并 依次 对 其 加 以 调用 。 该 函数 支持 多 个 函 
数 作为 参数 ， 相 关 示 例如 下 所 示 : 

longOperation({ notifyMainView() }, { notifyFooterView() }) 

另外 ，Kotlin 中 的 函数 还 可 返回 函数 。 例 如 ， 可 定义 某 个 函数 ， 并 创建 自 定义 错误 处 
理 程序 ， 其 中 包含 了 相同 的 错误 日 志 机 制 ， 以 及 不 同 的 标签 ， 如 下 所 示 : 

fun makeErrorHandler (tag: String) = fun (error: Throwable) { 

if(BuildConfig.DEBUG) Log.e(tag, error.message, error) 


toast (error.message) 
// Other methods, like: Crashlytics.logException (error) 





























} 


// Usage in project 
val adController = AdController (makeErrorHandler ("Ad in MainActivity") ) 


val presenter = MainPresenter (makeErrorHandler ("MainPresenter") ) 


// Usage 

val exampleHandler = makeErrorHandler ("Example Handler") 
exampleHandler (Error ("Some Error")) // Logs: Example Handler: Some 
Error 


当 采 用 参数 中 的 函数 时 ， 较 为 常见 的 3 种 情形 包括 : 
o 向 函数 提供 操作 。 

。 观察 者 (监听 器 模式。 

e 线程 操作 后 的 回调 行为 。 

下 面 对 此 予以 详细 介绍 。 


5.4.4. 向 函数 提供 操作 
第 4 章 曾 有 所 提 及 , 某 些 时 候 , 需要 从 函数 中 获取 常用 功能 项 , 但 其 操作 却 有 所 差异 。 
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在 这 种 情况 下 ， 我 们 仍 可 获得 该 功能 项 ， 但 需要 提供 一 个 参数 ， 并 包含 了 对 其 予以 区 分 的 
操作 。 通 过 这 种 方式 ， 即 可 获取 并 复 用 任意 常见 模式 。 例 如 ， 通 常 仅 需要 与 某 些 断 言 相 匹 
配 的 列表 元 素 ， 如 仅 需要 显示 某 些 活 动 元 素 。 对 此 ， 较 为 经 典 的 实现 方法 如 下 所 示 : 


var visibleTasks = emptyList<Task>() 
for (task in tasks) ( 

if (task.active) 

visibleTasks += task 
Jn 


尽管 这 可 视 作 一 类 常见 操作 ， 但 仍 可 根据 当前 断言 (predicate) 获取 功能 项 《〈 仅 过 滤 某 些 
元 素 )， 进 而 分 离 函数 ， 同 时 更 加 方便 地 对 其 加 以 使 用 ， 如 下 所 示 : 


fun «T» filter(list: List<T>, predicate: (T)->Boolean) ( 
var visibleTasks = emptyList<T>() 
for (elem in list) ( 
if (predicate (elem)) 
visibleTasks += elem 

















) 


var visibleTasks = filter(tasks, { it.active }) 


这 种 高 阶 函 数 的 应 用 方式 十 分 重要 ， 本 书 将 通 篇 对 此 加 以 描述 ， 但 并 非 是 高 阶 函 数 唯 一 的 
应 用 方式 。 


5.4. ”观察 者 ( 监听 器 ) 模式 


当 引 发 某 一 事件 并 执行 相关 操作 时 ， 可 采用 Observer (Listener) 模式 。 在 Android 开 
发 中 ， 观 察 者 常 被 设置 为 视图 元 素 。 常 见 的 示例 包括 单 击 监听 器 、 触 摸 监 听 器 或 文本 查看 
器 。 在 Kotlin 中 ， 可 设置 不 包含 任何 样本 文件 的 监听 器 。 例如， 下 列 代码 显示 了 按钮 单 击 
操作 的 监听 器 : 


button.setOnClickListener(( someOperation() }) 


YER, setOnClickListener 表示 为 Android 库 中 的 Java 方法 。 稍 后 将 会 详细 解释 为 何 要 利 
Lambda 表达 式 对 其 加 以 使 用 。 监 听 器 的 构建 过 程 较为 简单 ， 相 关 示 例如 下 所 示 : 
var listeners: List<()->Unit> = emptyList() // 1 


fun addListener(listener: ()-»Unit) ( 
listeners += listener // 2 
























































} 
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fun invokeListeners() ( 
for( listener in listeners) listener() // 3 


) 
针对 注释 1， 创 建 一 个 空 列表 并 加 载 全 部 监听 器 ， 对 于 注释 2， 可 简单 地 将 某 个 监听 器 添 
加 至 监听 器 列表 中 ; 在 注释 3 中 ， 遍 历 监 听 器 并 逐一 对 其 加 以 调用 。 

该 模式 的 实现 过 程 十 分 简单 。 除 此 之 外 , 另 一 种 常见 应 用 〈 基 于 函数 类 型 的 参数 应 用 ) 
是 线程 操作 后 的 回调 。 


5.4.3 ”线程 操作 后 的 回调 


如 果 操 作 较 为 耗 时 ， 且 不 希望 用 户 长 时 间 等 待 ， 则 需要 在 另 一 个 线程 中 启动 该 操作 。 
为 了 在 独立 线程 中 调用 耗 时 操作 之 后 使 用 回调 ， 可 将 其 作为 参数 予以 传递 ， 示 例 函 数 如 下 
所 示 : 


fun longOperationAsync(longOperation: ()->Unit, callback: ()->Unit) ( 
Thread(( // 1 
longoperation() // 2 
callback() // 3 
Jysstart(Q) / 4 
} 







































































// Usage 

longOperationAsync( 
longOperation = { Thread.sleep(1000L) }, 
callback = { print("After second") } 
// 5, Prints: After second 


) 
println("Now") // 6, Prints: Now 


在 注释 1 中 ， 创 建 了 Thread， 同 时 还 传递 了 希望 在 构造 器 参数 上 执行 的 Lambda 表达 式 ; 
在 注释 2 中 ， 执 行 了 较为 耗 时 的 操作 ; 在 注释 3 中 ， 启 用 了 当前 参数 提供 的 回调 操作 ; 在 
注释 4 中 ，start 表示 为 启动 所 定义 线程 的 方法 ; 在 注释 S 中 ，1 秒 延 迟 后 实现 输出 ; EE 
释 6 中 ， 实 现 了 即时 输出 。 
实际 上 ， 对 于 回调 应 用 ， 还 存在 一 些 较为 常见 的 蔡 代 方法 ， 例 如 RxJava。 当 然 ， 经 典 
调 方式 依然 十 分 常见 。 在 Kotlin 中 ， 其 实现 方式 一 般 不 包含 任何 样板 文件 。 

当 采 用 高 阶 函 数 时 , 上 述 形式 是 最 为 常见 的 用 例 , 旨 在 获取 常见 行为 并 减少 样板 文件 。 
关于 高 阶 函数 ，Kotlin 支持 大 量 的 改进 措施 。 
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55 命名 参数 和 Lambda 表达 式 的 组 合 





在 Android 开发 中 ， 默 认命 名 参数 和 Lambda 表达 式 十 分 有 用 ， 下 面 考察 Android 中 
的 一 些 实际 用 例 。 假设 通 过 某 个 函数 下 载 某 些 元 素 , 并 向 用 户 显示 , 其 中 将 添加 下 列 参数 : 
eonStart: 在 网 络 开启 之 前 进行 调用 。 
eonFinish: 在 网 络 开启 之 后 被 调用 。 


fun getAndFillList(onStart: () -> Unit = {}, 
onFinish: () -> Unit = {}){ 
// code 





















































$ 
随后 ， 即 可 在 onStart 和 onFinish 中 显示 或 隐藏 旋转 加 载 图 标 ， 如 下 所 示 : 


getAndFillList( 
onStart = ( view.loadingProgress = true } , 
onFinish = ( view.loadingProgress = false } 


) 
如 果 需 要 从 swipeRefresh 启动 ， 仅 须 在 其 结束 时 进行 隐藏 ， 如 下 所 示 : 


getAndFillList (onFinish = { view.swipeRefresh.isRefreshing = 
false }) 


如 果 需 要 执行 更 新 操作 ， 则 可 按照 下 列 方式 加 以 调用 : 

getAndFillList() 

对 于 多 功能 函数 来 讲 ， 命 名 参数 和 Lambda 表达 式 可 视 为 一 种 较为 完美 的 组 合 ， 可 选 
取 期 望 实现 的 参数 ， 以 及 应 实现 的 相关 操作 。 如 果 某 个 函数 包含 了 多 个 函数 类 型 参数 ， 那 
么 ， 在 大 多 数 时 候 ， 应 通过 命名 参数 语法 加 以 使 用 ， 其 原因 在 于 ， 当 使 用 多 个 函数 类 型 参 
数 时 ，Lambda 表达 式 一 般 不 具备 自 解释 特性 。 


5.6 参数 规则 中 最 后 一 个 Lambda 

















在 Kotlin 中 ,高 阶 函数 十 分 重要 ， 这 也 是 Kotlin 对 此 引入 了 特殊 规则 的 原因 一 一 使 高 
阶 函数 更 加 简单 明了 ， 其 工作 方式 可 描述 为 : 如 果 最 后 一 个 参数 表示 为 函数 ， 则 可 在 括号 
外 部 定义 一 个 Lambda 表达 式 。 下 面 考察 与 longOperationAsync 结合 使 用 时 ， 该 表达 式 的 
表现 结果 ， 相 关 定义 如 下 所 示 : 
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fun longOperationAsync(a: Int, callback: ()-»Unit) ( 
WE sna 
l 
该 函数 类 型 位 于 参数 中 的 最 后 位 置 ， 并 可 通过 下 列 方式 执行 : 


longOperationAsync(10) { 
hideProgress () 
} 
考虑 到 参数 规则 中 最 后 一 个 Lambda, 可 将 Lambda 置 于 括号 之 后 ， 以 使 其 看 起 来 位 于 
参数 外 部 。 
作为 示例 ， 下 面 考察 在 Kotlin 中 ， 代 码 在 另 一 个 线程 中 的 调用 方式 。 在 Kotlin 中 ， 新 
线程 的 标注 启动 方式 可 描述 为 ， 从 Kotlin 标准 库 中 使 用 线程 函数 ， 其 定义 如 下 所 示 : 
public fun thread( 
start: Boolean = true, 
isDaemon: Boolean - false, 
contextClassLoader: ClassLoader? - null, 
name: String? - null, 
priority: Int - -1, 
block: () -» Unit): Thread ( 
// implementation 
) 


不 难 发 现 ，block 参数 接收 异步 调用 的 操作 ， 并 位 于 最 后 一 个 位 置 。 其 他 参数 包含 默 
认 的 定义 参数 。thread 函数 的 使 用 方式 如 下 所 示 : 

thread { /* code */ } 

thread 定义 包含 了 多 个 其 他 参数 ， 其 设置 方式 可 使 用 命名 参数 语法 ， 或 者 采用 逐一 方 
式 予 以 提供 ， 如 下 所 示 : 


thread (name = "SomeThread") ( /*...*/ } 
thread (false, false) { /*...*/ } 


参数 规则 中 的 最 后 一 个 Lambda 表示 为 语法 糖 ， 但 可 简化 高 阶 函数 的 应 用 方式 。 该 规 
则 的 差异 性 主要 体现 在 下 列 两 个 常见 用 例 中 : 

e 命名 代码 的 包围 机 制 。 

e 利用 LINQ 风格 处 理 数据 结构 。 

下 面 对 此 加 以 详细 讨论 。 
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5.6.1 命名 代码 的 包围 机 制 


某 些 时 候 , 需要 以 不 同方 式 标记 执行 代码 中 的 部 分 内 容 , thread 函数 即 属于 这 一 类 情况 。 
其 中 ， 代 码 须 异 步 执行 ， 因 而 可 采用 起 始 于 thread 函数 的 括号 对 其 加 以 包围 ， 如 下 所 示 : 


thread { 
operationl() 
operation? () 
F 


从 外 部 来 看 ， 这 似乎 是 代码 的 一 部 分 内 容 ， 并 被 名 为 thread 的 代码 块 所 围绕 。 下 面 考察 另 
一 个 示例 ， 并 假设 需要 记录 特定 代码 块 的 执行 时 间 。 作 为 一 个 帮助 函数 ， 可 定义 addLogs 
函数 ， 该 函数 输出 日 志和 时 间 ， 其 定义 方式 如 下 所 示 : 


fun addLogs(tag: String, f: () -> Unit) ( 

println("$tag started") 

val startTime - System.currentTimeMillis() 

f£ 

val endTime - System.currentTimeMillis() 

println("$tag finished. It took " + (endTime - startTime) 
) 


该 函数 的 应 用 方式 如 下 所 示 : 


addLogs ("Some operations") { 
// Operations we are measuring 







































































} 
对 应 的 执行 示例 如 下 所 示 : 


addLogs ("Sleeper") { 
Thread.sleep (1000) 
} 


当 执 行 处 理 代码 时 ， 将 产生 下 列 输 出 结果 : 


Sleeper started 
Sleeper finished. It took 1001 


当然 ， 实 际 的 输出 毫秒 数 将 稍 有 差异 。 
由 于 某 些 模式 与 代码 库 连 接 ， 因 而 当前 模式 在 Kotlin 项 目 中 十 分 有 用 。 例 如 ， 可 在 执 
行 某 些 特性 之 前 ， 检 测 APT 版 本 是 否 大 于 Android 5.x Lollipop。 对 此 ， 可 使 用 下 列 条 件 : 


if (Build.VERSION.SDK INT >= Build.VERSION CODES.LOLLIPOP) { 


















































// Operations 
} 


但 在 Kotlin 中 ， 可 通过 下 列 方式 获取 函数 ， 


fun ifSupportsLolipop(f:()->Unit) { 
if (Build.VERSION.SDK INT >= Build.VERSION CODES.LOLLIPOP) 
{ 





EO 
} 
} 


// Usage 
ifSupportsLollipop ( 
// Operation 

) 


24155;* 


该 方式 不 仅 较为 适宜 ， 同 时 也 减少 了 代码 的 元 余 性 ， 因 而 在 具体 操作 中 视 为 一 种 较 好 的 操 





作 方 案 。 需 要 注意 的 是 ， 该 规则 可 定义 一 类 控制 结构 ， 并 以 标准 形式 相 类 似 的 方式 了 


LE o 





例如 ， 可 定义 一 种 简单 的 控制 结构 ， 若 代码 体 中 的 语句 未 返回 任何 错误 即 可 运行 ， 
和 应 用 方式 如 下 所 示 : 
fun repeatUntilError(code: ()->Unit): Throwable { 
while (true) ( 


try ( 
code () 
) catch (t: Throwable) ( 
return t 
} 
} 
} 
// Usage 
val tooMuchAttemptsError = repeatUntilError ( 
attemptLogin() 


) 




















其 定义 


除 此 之 外 ， 其 优点 还 体现 在 : 自 定义 的 数据 结构 还 可 返回 一 个 值 。 其 中 ， 最 引 人 和 人 瞩目 











之 处 在 于 ， 无 须 其 他 附加 语言 的 支持 ， 即 可 定义 几乎 任意 所 需 的 控制 结构 。 
5.6.2 ”利用 LINQ 风格 处 理 数据 结构 








前 述 内 容 曾 提 到 ，Kotlin 支持 LINQ 风格 的 处 理 。 参 数 规则 中 的 最 后 一 个 Lambda 表 
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示 为 男 一 个 组 件 ， 并 可 提升 可 读 性 。 例 如 ， 考 察 下 列 代码 : 


strings.filter { it.length == 5 }.map { it.toUpperCase() } 


与 参数 规则 中 未 使 用 最 后 一 个 Lambda 相 比 ， 其 可 读 性 获得 了 显著 的 提升 ， 如 下 所 示 : 


strings.(( s -> s.length == 5 }).map({ s -> s.toUpperCase() }) 








再 次 说 明 ， 该 处 理 过 程 将 在 第 7 章 详细 讨论 ， 当 前 仅 讨论 了 与 改善 可 读 性 相关 的 两 种 
特性 (参数 规则 中 最 后 一 个 Lambda， 以 及 单一 参数 的 隐 式 名 称 )。 

参数 规则 中 最 后 一 个 Lambda 也 是 Kotlin 特征 之 一 ， 经 引入 后 可 改善 Lambda 表达 式 
的 应 用 体验 ， 其 具体 改进 措施 也 较为 丰富 ， 相 关 方 案 的 协同 工作 方式 十 分 重要 ， 则 在 提升 
高 阶 函数 的 简洁 性 、 可 读 性 以 及 效率 。 
































5.7 Kotlin 中 的 Java SAM 支持 


在 Kotlin 中 ,高 阶 函数 的 使 用 方式 较为 简单 ,其 问题 主要 体现 在 与 Java 的 互 操 作 方 面 ， 
而 Kotlin 对 此 并 未 提供 本 地 支持 。 对 此 ， 可 采用 仅 包含 单一 方法 的 接口 予以 替代 ， 此 类 接 
称 作 单一 抽象 方法 (SAM) 或 函数 式 接口 。 对 此 ， 较 好 的 示例 〈 通 过 该 方式 构建 一 个 函 
HO) 是 在 View 元 素 上 使 用 setOnClickListener。 在 Java 版 本 8 之 前 ， 除 了 使 用 匿名 内 部 类 
之 外 ， 尚 无 简单 的 实现 方法 ， 如 下 所 示 : 

// Java 

button.setOnClickListener(new OnClickListener() ( 


@override public void onClick(View v) { 
// Operation 









































} 
he 
在 上 述 示例 中 ，OnClickListener 方法 定义 为 SAM， 其 中 仅 包 含 了 单一 方法 onClick. RI 
SAM 实际 上 常用 作 函 数 定 义 的 蔡 代 方案， 但 Kotlin 也 对 其 生成 了 一 个 构造 函数 ， 并 作为 
参数 包含 了 函数 类 型 ， 称 作 SAM 构造 函数 。SAM 构造 函数 可 创建 Java SAM 接口 实例 ， 
即 调用 其 名 称 并 传递 函数 字面 值 ， 如 下 所 示 : 


button.setOnClickListener(OnClickListener { 
y A 


















































}) 
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BHF GARTA-PREK, HELTRE BA. # Kotlin F, & 
含 两 种 函数 字面 值 : 
(1) 匿名 函数 。 


qp (29) Lambda 表达 式 。 


两 种 函数 字面 值 均 可 描述 为 : 
val a = fun()) {} // Anonymous function 
val b = {} // Lambda expression 
更 好 的 方案 是 ， 针 对 接收 SAM 的 各 个 Java 方法 ，Kotlin 编译 器 将 生成 某 个 版 本 ， 并 作为 
参数 接收 函数 ， 因 此 可 按照 下 列 方式 设置 OnClickListener: 
button.setOnClickListener ( 
// Operations 
) 
回忆 一 下 ，Kotlin 编译 器 仅 对 Java SAM 生成 SAM 构造 函数 以 及 函数 方法 ， 且 并 不 会 针对 
包含 单一 方法 的 Kotlin 接口 生成 SAM 构造 函数 。 当 采用 Kotlin 编写 函数 并 包含 一 个 SAM 
时 ， 则 无 法 将 其 用 作 Java 方法 〈 基 于 参数 SAM)， 如 下 所 示 : 
interface OnClick ( 


fun call() 
} 


























fun setOnClick(onClick: OnClick) { 


Wise 
) 


setonClick ( ) // 1. Error 
在 注释 1 中 ， 由 于 setOnClick 函数 采用 Kotlin 编写 ， 因 而 无 法 实现 正常 工作 。 
在 Kotlin 中 ， 接 口 不 应 采用 这 一 方式 予以 使 用 。 对 此 ， 推 荐 方法 是 使 用 函数 类 型 ， 而 
非 SAM， 如 下 所 示 : 


fun setOnClick(onClick: ()->Unit) ( 
lus 












































H 


setOnClick { } // Works 


Kotlin 编译 器 针对 定义 于 Java 中 的 各 个 SAM 接口 生成 构造 函数 ， 该 接口 仅 包 含 蔡 换 
某 个 SAM 的 函数 类 型 。 考 察 下 列 接 
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// Java, inside View class 

public interface OnClickListener ( 
void onClick(View v); 

} 


可 通过 下 列 方式 在 Kotlin 中 加 以 使 用 : 
val onClick = View.OnClickListener { toast("Clicked") } 
或 者 作为 函数 参数 予以 提供 ， 如 下 所 示 : 


fun addOnClickListener(d: View.OnClickListener) {} 
addonClickListener( View.OnClickListener ( v -> println(v) }) 


下 列 代码 显示 了 Android 中 Java SAM Lambda 接口 和 方法 示例 : 


view.setOnLongClickListener ( /* ... */; true } 
view.onFocusChange ( view, b -> /* ... */ } 
val callback = Runnable ( /* ... */ } 


view.postDelayed(callback, 1000) 
view.removeCallbacks (callback) 


下 列 代码 显示 了 RxJava 示例 : 


observable.doOnNext ( /* ... */ } 
observable.doOnEach ( /* ... */ } 


下 面 考察 Kotlin 中 SAM 定义 替代 方案 的 实现 方式 。 
58 命名 Kotlin 函数 类 型 




















Kotlin 并 不 支持 定义 于 Java 中 的 SAM 类 型 转换 ， 对 此 ， 推 荐 方法 是 使 用 函数 类 型 。 
但 SAM 对 经 典 函 数 并 不 存在 优势 ， 即 名 称 和 命名 参数 。 较 好 的 方法 是 ， 若 函数 类 型 定义 
较 长 ， 或 作为 参数 多 次 被 传递 ， 则 须 命 名 该 函数 类 型 ;另外 ， 若 仅 通过 类 型 无 法 判断 各 个 
参数 的 含义 ， 则 应 定义 命名 参数 。 
在 后 续 章 节 中 ， 读 者 将 会 看 到 ， 可 对 参数 和 函数 类 型 全 部 定义 予以 命名 ， 并 通过 类 型 
别名 以 及 函数 类 型 中 的 命名 参数 予以 实现 。 通 过 这 一 方式 ， 即 可 在 持 有 函数 类 型 的 前 提 下 
发 挥 SAM 的 各 种 优点 。 


5.8.1 ”函数 类 型 中 的 命名 参数 
截止 到 目前 ， 前 述 内 容 仅 讨论 了 函数 类 型 定义 其中， 仅 指定 相关 类 型 )， 但 并 未 涉 











第 5 章 函数 一 一 一 等 公民 * 159* 








及 参数 名 。 相 应 地 ， 参 数 名 已 在 函数 字面 值 中 加 以 定义 ， 如 下 所 示 : 


fun setOnItemClickListener(listener: (Int, View, View)-»Unit) ( 
// code 

















} 
setOnItemClickListener { position, view, parent -» /* ... */ } 


若 参数 不 具备 自 解释 特征 ， 且 开发 人 员 无 法 了 解 参数 的 具体 含义 ， 则 问题 也 会 随 之 出 
现 。 当 采用 SAM 时 ， 其 中 包含 了 一 些 应 用 建议 ， 但 在 前 述 示例 中 定义 的 函数 类 型 中 ， 此 
类 建议 并 未 起 到 应 有 的 效果 ， 如 图 5.2 所 示 。 


fun setOnItemClickListener(listener: (Int, View, View)->Unit) { 
// code 
































} 
setOnItemClickListener 


i: Int, view: View, view: View -> 


* setOnItemClickListener(listener: (Int, View, View) -> Un. Unit 
© setOnItemClickListener ( Int, View, View -> ... } (liste. Unit 
® > print (message: Boolean) (koti:n.:60) Unit 
® » print (message: Int) (kotl:n.io) Unit 
Ð > print (message: Any?) (kotLin.io) Unit 
W » print (message: Byte) (kotlin.io) Unit 
W > print (message: Char) (kotlin.io) Unit 
* © print(message: Long) (Kotlin.io) Unit 
[bid you know that Guick Documentation View (Ciri+G} works in completion lookups as well? >>"  [r 
图 52 


该 方案 则 在 利用 命名 参数 定义 函数 类 型 ， 如 下 所 示 : 

(position: Int, view: View, parent: View)->Unit 
这 一 形式 的 优点 在 于 ，IDE 可 作为 函数 字面 值 中 的 参数 名 称 给 予 名 称 提示 。 据 此 ， 程 序 员 
消除 某 些 歧 义 ， 如 图 5.3 所 示 。 


fun setünClickListener(onClick: (position: Int, view: View, parent: View)->Unit) { 
HU .. 
) 


fun main(args: Array«String») ( 
? setOnClickListener 


} 





position: Int, view: View, parent: View -> 
® © main(args: Array<String>) (<root>) Unit 
® > setOnClickListener (onClick: (Int, View, View) -> Unit) (. Unit 
™ > setOnClickListener { position, view, parent -> ... ) (on. Unit 








P è tryFewTimes {...} | , f: () -> Unit) («ro ) Unit 
try {...} 

P s tryFewTimes(times: Int = ..., f: () -> Unit) («root») Unit 

® © main(args: Array<String>) ot» Unit 

® » addClassic (node: Pn tno QE D («root») Unit 


@ add Inada. DinaruTran- T~? Di neryTran-T~ 
Did you know that Quick Definition View (Ori FSRR H) works in completion lookups as well?” 25: >> mj 


图 5.3 
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当 同 一 函数 类 型 多 次 使 用 时 , 问题 便 会 出 现 , 因而 难以 针对 各 个 定义 指定 对 应 的 参数 。 
此 时 ， 可 采用 Kotlin 中 类 型 别名 这 一 特性 。 


5.82 ”类 型 别名 


自 版 本 1.1 UR, Kotlin 支持 类 型 别名 这 一 特性 ， 并 可 针对 现 有 类 型 提供 替换 名 称 。 
下 列 代码 显示 了 类 型 别名 定义 示例 ， 其 中 生成 了 一 个 Users 列表 。 


data class User(val name: String, val surname: String) 
typealias Users - List«User» 


通过 这 一 方式 ， 可 向 现 有 数据 类 型 中 添加 更 多 具有 实际 含义 的 名 称 ， 如 下 所 示 : 

typealias Weight = Double 

typealias Length - Int 

类 型 别名 须 在 顶级 位 置 处 进行 声明 。 对 此 ， 可 见 修饰 符 可 应 用 于 类 型 别名 ， 进 而 调整 
其 适用 范围 ， 且 默认 条 件 下 为 public 类 型 。 这 也 意味 着 ， 之 前 定义 的 类 型 别名 可 无 限制 地 
加 以 使 用 ， 如 下 所 示 : 

val users: Users = listof( 


User("Marcin", "Moskala"), 
User("Igor", "Wojda") 














) 


fun calculatePrice(length: Length) ( 
UE a 

} 

calculatePrice(10) 


val weight: Weight = 52.0 
val length: Length = 34 


需要 注意 的 是 ， 别 名 用 于 改善 代码 的 可 读 性 ; 同时 ， 仍 可 交互 使 用 原始 类 型 ， 如 下 
所 示 : 

typealias Length = Int 

var intLength: Int = 17 

val length: Length = intLength 

intLength = length 
typealias 的 另 一 种 应 用 则 是 缩短 较 长 的 泛 型 ， 并 向 其 赋予 更 具 含义 的 名 称 。 当 同一 类 型 在 
代码 中 多 处 出 现时 ， 这 可 有 效 地 改进 代码 的 可 读 性 和 一 致 性 ， 如 下 所 示 : 
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typealias Dictionary<V> = Map<String，V> 
typealias Array2D<T> = Array<Array<T>> 


类 型 别名 常用 于 命名 函数 类 型 ， 如 下 所 示 : 


typealias Action«T» = (T) -> Unit 
typealias CustomHandler = (Int, String, Any) -> Unit 


相应 地 ， 可 结合 函数 类 型 参数 名 对 其 加 以 使 用 ， 如 下 所 示 : 
typealias OnElementClicked = (position: Int, view: View, parent: View)-»Unit 


随后 即 可 查看 到 相应 的 参数 提示 ， 如 图 5.4 所 示 。 


typealias OnElementClicked = (position: Int, view: View, parent: View)->Unit 





fun main(args: Array<String>) ( 
W setOnClickListener 


position: Int, view: View, parent: View -> 
f» main (args: Array<String>) («root») Unit 
* »setOnClickListener(onClick: OnElementClicked /* = (Int, ~ Unit 
P> setOnClickListener { position, view, parent -> ... ) (on. Unit 


* s tryFewTimes {...} | , f: () -> Unit) («root») Unit 
try {... 
Ð s tryFewTimes (times: Int = ..., f: () -> Unit) (<root>) Unit 
: » main (args: Array<String>) (<root>) Unit 
» addClassic(node: BinaryTree<T>?, TELE T) («root») Unit 
addinadas BinsruTran T4? nlnm: rants) BinsruTranzTs. 
Use Ci Shiv Enter to syntactically correct your code after completing (balance parentheses eic Soin) 
图 5.4 





下 面 考察 类 型 别名 命名 的 函数 类 型 的 实现 方式 〈 基 于 类 )。 在 该 示例 中 ， 函 数 类 型 的 
参数 类 型 建议 为 方法 参数 名 ， 如 下 所 示 : 


typealias OnElementClicked - (position: Int, view: View, parent: View)->Unit 




















class MainActivity: Activity(), OnElementClicked ( 


override fun invoke(position: Int, view: View, parent: View) ( 
// code 
) 
) 


使 用 命名 函数 类 型 的 主要 原因 包括 : 
e 与 全 部 函数 类 型 定义 相 比 ， 名 字 更 加 简短 、 易 用 。 
e 当 传递 函数 时 ， 在 修改 其 定义 后 ， 若 使 用 类 型 别名 ,， 则 无 须 在 其 他 处 对 其 进行 调整 。 
e 使 用 类 型 别名 时 ， 可 方便 地 设置 所 定义 的 参数 名 。 
当 结 合 使 用 两 种 特性 后 〈 即 函数 类 型 中 的 命名 参数 和 类 型 别名 )， 则 无 须 在 Kotlin 中 
定义 SAM 一 一 对 于 函数 类 型 而 言 ，SAM 中 的 全 部 优点 〈 名 称 和 命名 参数 ) 均 可 通过 函数 
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类 型 定义 中 的 命名 参数 和 参数 别名 予以 实现 。 同 时 ， 这 也 体现 了 Kotlin 对 于 函数 式 编程 的 
另 一 种 支持 。 





5.99 ”针对 未 使 用 变量 的 下 划 线 


在 某 些 场合 下 ， 所 定义 的 Lambda 表达 式 并 不 会 使 用 其 全 部 参数 。 当 保留 其 命名 状态 
时 ， 可 能 会 对 程序 员 理解 Lambda 表达 式 及 其 功能 产生 负面 影响 。 下 面 考 察 过 滤 第 二 个 参 
数 的 函数 。 其 中 ， 第 二 个 参数 表示 为 元 素 值 ， 在 当前 示例 中 未 予 使 用 ， 如 下 所 示 : 
































list.filterIndexed { index, value -> index $ 2 == 0 } 
为 了 消除 误解 ， 此 处 采用 了 多 项 约定 ， 例 如 忽略 参数 名 ， 如 下 所 示 : 
list.filterIndexed { index, ignored -> index $ 2 == 0 } 


鉴于 此 类 约定 尚 不 完善 ， 因 而 Kotlin 引入 了 下 划 线 符号 ， 用 于 未 使 用 的 参数 名 的 替代 
方案 ， 如 下 所 示 : 


list.filterIndexed { index, _ -> index $ 2 == 0 } 


此 处 建议 使 用 该 符号 ， 当 未 使 用 Lambda 表达 式 参数 时 ， 将 显示 一 条 警告 信息 ， 如 图 5.5 
所 示 。 








listof(10, 10, 18).filterIndexed ( index, ek -> index $2 — 0 ) 





| Parameter ‘elem’ is never used, could be renamed to _ | 





图 5.5 
5.10 Lambda 表达 式 中 的 解构 机 制 


第 4 章 曾 讨 论 了 对 象 如 何 通 过 解构 声明 解构 为 多 个 属性 ， 如 下 所 示 : 


data class User(val name: String, val surname: String, val phone: String) 


val (name, surname, phone) = user 
自 版 本 1.1 起 ，Kotlin 针对 Lambda 参数 使 用 了 解构 声明 语法 。 对 此 ， 须 采用 括号 包含 
全 部 需要 解构 的 参数 ， 如 下 所 示 : 


val showUser: (User) -> Unit = ( (name, surname, phone) -> 
println("$name $surname have phone number: $phone") 





l 
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val user = User("Marcin", "Moskala", "+48 123 456 789") 
ShowUser (user) 
// Marcin Moskala have phone number: +48 123 456 789 


Kotlin 的 解构 声明 基于 位 置 ,而 非 基 于 名 称 的 解构 声明 ,例如 TypeScript. 
在 基于 位 置 的 解构 声明 中 ， 属 性 顺序 决定 了 对 应 属性 赋予 哪个 变量 。 在 基于 
名 称 的 解构 机 制 中 ， 则 由 变量 名 予以 确定 ， 如 下 所 示 


// TypeScript 
const obj = ( first: 'Jane', last: 'Doe' }; 


€ const ( last, first } = obj; 
console.log(first); // Prints: Jane 
console.log(last); // Prints: Doe 
两 种 方案 各 具 优 缺点 。 其 中 ， 基 于 位 置 的 解构 声明 适用 于 某 个 属性 的 重 
命名 操作 ， 但 对 于 属性 重 排序 而 言 ， 则 缺少 应 有 的 安全 性 。 相 比较 而 言 ， 基 
于 名 称 的 解构 声明 对 于 属性 重 排序 来 说 较为 安全 , 但 不 适用 于 属性 的 重 命名 。 


解构 声明 可 在 单一 Lambda 表达 式 中 使 用 多 次 , 并 可 与 常规 参数 结合 使 用 , 如 下 所 示 : 
val fl: (Pair<Int, String>)->Unit = ( (first, second) -> 
ie code SH A 
val f2: (Int, Pair<Int, String>)->Unit = { index, (f, s)-> 
/*® code */ y // 2 
val f3: (Pair<Int, String>, User) ->Unit = { (f, s), (name, 
surname, tel) ->/* code */ } // 3 
在 注释 1 tF, Pair 解构 ; 在 注释 2 中 ，Pair 和 其 他 元 素 的 解构 ; 在 注释 3 H, H— Lambda 
表达 式 中 的 多 个 解构 。 
注意 ， 可 将 某 个 类 解构 为 小 于 所 有 组 件 ， 如 下 所 示 : 
val f: (User)->Unit = { (name, surname) -> /* code */ } 
解构 声明 中 支持 下 划 线 符号 ， 常 用 于 获取 更 深 一 层 的 组 件 ， 如 下 所 示 : 
val f: (User)->Unit = ( (name, , phone) -> /* code */ } 
val third: (List«Int»)-»Int = ( ( , , third) => third } 
解构 参数 的 类 型 可 通过 下 列 方式 指定 : 


val f = ( (name, surname): User -> /* code */ } //1 


在 注释 1 中 ,对 应 类 型 根据 当前 Lambda 表达 式 进行 推断 ; 在 注释 2 中 ,由 于 缺少 Lambda 
表达 式 中 与 类 型 相关 的 足够 信息 ， 因 而 具体 类 型 无 法 被 推断 。 
这 也 使 得 Lambda 中 的 解构 成 为 一 项 有 用 的 特性 。 下 面 考察 Android 中 某 些 较为 常见 
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的 用 例 。 该 示例 用 于 处 理 Map 元 素 ， 对 应 元 素 类 型 为 Map.Entry， 并 解构 为 key 和 value 
参数 ， 如 下 所 示 : 


val map = mapOf(1 to 2, 2 to "A") 
val text = map.map { (key, value) -> "$key: $value" } 
println (text) // Prints: [1: 2, 2: A] 


类 似 地 ，Pairs 列表 可 解构 为 : 


val listOfPairs = listOf(1 to 2, 2 to "Rn) 

val text - listOfPairs.map ( (first, second) -» 
"$first and $second" } 

println(text) // Prints: [1 and 2, 2 and A] 


当 尝 试 简化 数据 对 象 处 理 时 ， 也 可 使 用 解构 声明 ， 如 下 所 示 : 


fun setOnUserClickedListener(listener: (User)->Unit) { 
listView.setOnItemClickListener ( , , position, -> 
listener (users [position]) 





) 


setonUserClickedListener { (name, surname) -> 
toast("Clicked to $name $surname") 
H 


当 用 于 异步 处 理 元 素 时 ， 该 方案 十 分 有 用 例如 RxJava)。 其 中 ， 对 应 函数 设计 为 处 
理 单一 元 素 ， 若 需要 处 理 多 个 元 素 ， 则 应 将 其 包装 至 Pair. Triple 或 其 他 一 些 数据 类 中 ， 
同时 在 每 个 步骤 上 使 用 解构 声明 ， 如 下 所 示 : 

getQuestionAndAnswer () 

.flatMap { (question, answer) -> 
view.showCorrectAnswerAnimationObservable (question, answer) 


) 
-subscribe( ( (question, answer) -> /* code */ } ) 
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高 阶 函 数 十 分 有 效 ， 并 可 改善 代码 的 复 用 性 。 然 而 ， 其 中 一 个 最 大 的 问题 是 如 何 高 效 
地 对 其 加 以 使 用 。Lambda 表达 式 可 编译 为 类 (通常 为 匿名 类 ); 另外 ，Java 中 对 象 的 创建 
任务 也 是 一 项 较为 繁重 的 工作 。 对 此 ， 可 通过 较为 高 效 的 方式 使 用 高 阶 函数 ， 同 时 利用 函 
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数 内 联机 制 保留 其 全 部 优点 。 

内 联 函数 这 一 概念 历史 相对 悠久 ,， 且 多 与 C++ 或 C 语言 相关 。 当 某 一 函数 标记 为 内 联 
函数 时 ,在 代码 编译 期 间 , 编译 器 利用 实际 的 函数 体 蔡 换 全 部 函数 调用 , 且 不 再 视 为 函数 ， 
而 是 真实 的 代码 。 这 使 得 字 节 码 较 为 元 长 ， 但 运行 期 执行 将 更 加 高 效 。 稍 后 ， 读 者 将 会 看 
到 ， 几 乎 源 自 标准 库 中 的 全 部 高 阶 函数 均 标记 为 内 联 函 数 。 下 列 示例 通过 inline 修饰 符 标 
id printExecutionTime 函数 。 











inline fun printExecutionTime(f: () -> Unit) ( 
val startTime = System.currentTimeMillis() 
EN 
val endTime = System.currentTimeMillis() 
println("It took " + (endTime - startTime)) 
) 


fun measureOperation() ( 
printExecutionTime ( 
longOperation () 
} 
} 


当 编 译 或 反 编译 measureOperation 时 ， 将 会 发 现 ， 函 数 调用 被 真实 的 代码 体 所 替代 ， 
参数 函数 调用 则 通过 Lambda 表达 式 的 代码 体 被 替换 ， 如 下 所 示 : 


fun measureOperation() { 
val startTime - System.currentTimeMillis() // 1 
longoperation() // 2 
val endTime = System.currentTimeMillis() 
println("It took " + (endTime - startTime)) 

) 


在 注释 1 中 , US EI printExecutionTime 中 的 代码 被 添加 至 measureOperation 函数 体 中 。 在 注 
fk 2 rh, Lambda 内 的 代码 位 于 其 自身 调用 中 。 如 果 函 数 对 其 加 以 多 次 使 用 ， 代 码 将 替换 
各 次 调用 。 














printExecutionTime 的 代码 体 仍 可 在 代码 中 看 到 ， 省 略 该 代码 旨 在 提升 
当前 示例 的 可 读 性 , 并 在 编译 后 加 以 使 用 , 因而 仍 保留 于 当前 代码 中 。 例如 ， 
车 该 代码 作为 库 添加 至 某 个 项 目 中 , 而 且 ， 当 通过 Kotlin 加 以 使 用 时 ， 该 函 
数 仍 将 以 内 联 方式 工作 。 
虽然 无 须 针 对 Lambda 表达 式 创 建 类 ， 内 联 函 数 仍 可 加 速 函数 的 执行 过 程 ， 这 一 差别 
十 分 重要 ， 因 而 建议 针对 至 少 包 含 一 个 参数 的 全 部 短小 型 函数 使 用 内 联 修饰 符 。 然 而 ， 使 
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其 原因 
所 蔡 换 。 
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内 联 修饰 符 也 包含 负面 影响 。 首 先 ， 所 生成 的 字 节 码 较 长 ， 这 一 点 之 前 也 曾 有 所 提 及 。 
在 于 ， 函 数 调用 被 函数 体 所 替换 ， 该 函数 体内 的 Lambda 调用 被 函数 字面 值 代码 体 








另外 ， 内 联 函 数 无 法 实现 递归 ， 且 无 法 使 用 包含 多 个 限定 可 见 性 修饰 符 《〈 相 比 于 








Lambda 表达 式 ) 的 函数 或 类 。 例 如 ， 公 有 内 联 函 数 无 法 使 用 私有 函数 ， 其 原因 可 描述 为 
可 导致 代码 置 入 函数 中 且 无 法 正常 使 用 ， 进 而 产生 编译 错误 。 为 了 防止 这 一 问题 ，Kotlin 
不 允许 使 用 包含 小 于 Lambda 表达 式 的 限定 修饰 符 的 元 素 ， 如 下 所 示 : 


internal fun someFun() {} 
inline fun inlineFun() { 


} 




















someFun() // ERROR 


实际 上 ， 如 果 和 忽略 此 类 警告 ，Kotlin 仍 可 在 inline 函数 中 使 用 包含 多 个 
限定 可 见 性 修饰 符 的 元 素 ， 但 这 并 非 是 良好 习惯 ， 且 应 禁用 下 列 方式 : 


// Testerl.kt 
fun main(args: Array<String>) ( a() } 


// Tester2.kt 
inline fun a() { b() } 
private fun b() ( print("B") } 


qp 对 于 内 部 修饰 符 ， 其 实现 过 程 较为 简单 : 内 部 修饰 符 表示 为 public。 对 于 私 


另 一 


有 函数 , 则 存在 一 个 附加 的 access$b 函数 ,其 中 包含 了 public 可 见 性 修饰 符 ， 
且 仅 调用 b 函数 ， 如 下 所 示 : 


public static final void access$b() ( b(); } 
该 行为 旨 在 解释 : 某 些 时 候 ， 较 少 的 限定 修饰 符 仍 可 在 inline 函数 中 加 以 使 


用 ( 对 应 情形 可 在 Kotlin 1.1 标准 库 中 看 到 )。 在 相关 项 目 中 ， 可 利用 这 一 方 
式 设 计 元 素 ， 且 无 须 禁 用 某 些 操作 。 


个 问题 则 并 不 直观 。 虽 然 未 创建 Lambda， 但 仍 不 可 将 具有 函数 类 型 的 参数 传递 





至 另 一 个 函数 中 ， 如 下 所 示 : 


fun boo(f: ()->Int) { 


} 


Waas 


inline fun foo(f: () -> Int) { 


} 


boo (f) // ERROR, 1 
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若 函数 为 inline， 那 么 ， 其 函数 参数 无 法 传递 至 非 内 联 函数 中 。 
这 里 ， 具 体 原 因 可 解释 为 : 未 创建 下 参数， 该 参数 设计 为 由 函数 字面 值 予 以 替换 。 因 
此 ， 无 法 作为 参数 传递 至 另 一 个 函数 中 。 
对 此 ， 较 为 简单 的 处 理 方式 是 : 将 boo 函数 也 定义 为 内 联 函 数 。 在 大 多 数 时 候 ， 内 联 
函数 的 数量 不 可 过 多 ， 其 原因 包括 : 
e inline 函数 应 用 于 小 型 函数 。 如 果 定 义 了 使 用 其 他 inline 函数 的 inline 函数， 编译 后 
将 生成 较 大 的 结构 ， 这 一 问题 源 自 编译 器 以 及 最 终 的 代码 尺寸 。 
e 对 于 包含 超 量 可 见 性 修饰 符 的 元 素 ,inline 函数 无 法 对 其 加 以 使 用 ; 若 在 库 中 使 用 (多 
个 函数 为 私有 函数 且 对 API 予以 保护 )， 这 仍 将 会 产生 问题 。 
对 于 此 类 问题 ， 最 为 简单 的 处 理 方式 是 : 定义 相关 参数 ， 且 传递 至 另 一 个 noinline K 
数 中 。 


5.11.1 noinline 修饰 符 







































































noinline 是 针对 函数 类 型 参数 定义 的 修饰 符 , 并 将 特定 参数 视 为 常规 函数 类 型 参数 CH 
调用 并 不 会 被 函数 字面 值 蔡 换 )。noinline 函数 示例 如 下 所 示 : 


fun boo(f: ()-»Unit) ( 
MITES 











) 


inline fun foo(before: ()-»Unit, noinline f: () -» Unit) ( // 1 
before() // 2 
boo (f) // 3 

) 


在 注释 1 中 ，noinline 注释 修饰 符 位 于 参数 f 之 前 ; 在 注释 2 中 ，before 函数 被 Lambda 表 
达 式 体 〈 用 作 参 数 ) BHR: 在 注释 3 中 ，f 表 示 为 noinline， 因 而 可 被 传递 至 boo HAH. 
使 用 noinline 的 主要 原因 在 于 : 
e 需要 向 其 他 函数 传递 特定 的 Lambda。 
e 频繁 调用 Lambda， 但 不 希望 增加 代码 量 。 
需要 注意 的 是 ， 若 将 全 部 函数 参数 均 标 记 为 noinline， 内 联 函 数 的 性 能 基本 毫 无 变化 。 
虽然 使 用 inline 并 不 会 获得 收益 , 但 编译 器 还 是 会 显示 一 条 警告 消息 。 因 此 ，noinline 大 多 
数 时 候 仅 用 于 多 个 函数 参数 ， 同 时 仅 将 其 用 于 部 分 参数 。 


5.11.2” 非 本 地 返回 
包含 函数 参数 的 函数 其 行为 类 似 于 本 地 结构 (例如 循环 结构 )。 前 述 内 容 已 经 查看 了 
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ifSupportsLolipop 和 repeatUntilError 函数 。 更 为 常见 的 示例 则 是 forEach 修饰 符 , 并 可 作为 
for 控制 结构 的 替代 方案 ， 同 时 依次 调用 包含 各 元 素 的 参数 函数 。 下 列 代码 展示 了 实现 过 
FE (Kotlin 标准 库 中 存在 forEach 修饰 符 , 但 稍 后 将 会 看 到 ,其 中 包含 了 尚未 出 现 的 元 素 ): 


fun forEach(list: List«Int», body: (Int) -> Unit) ( 
for (i in list) body(i) 





} 

// Usage 

wal list = Prstof(t, 2, 3, 4, 5) 
forEach(list) ( print(it) ) // Prints: 12345 


这 里 的 问题 是 ， 通 过 当前 方式 定义 的 forEach 函数 ， 将 无 法 从 外 部 函数 中 返回 。 例 如 ， 
下 列 代码 显示 了 基于 for 循环 的 maxBounded 函数 实现 方式 : 


fun maxBounded (list: List<Int>, upperBound: Int, lowerBound: Int): 
Int { 
var currentMax = lowerBound 
torti in Vist) f 
when { 
i > upperBound -> return upperBound 
i > currentMax -> currentMax = i 
5 
} 
return currentMax 
} 


如 果 希 望 将 forEach PLAN for 循环 的 蔡 代 方案 , 类 似 的 情形 还 将 会 出 现 并 被 支持 。 具体 问题 
将 体现 为 :代码 无 法 被 编译 (使 用 forEach 而 非 for 循环 )， 如 图 5.6 所 示 。 


fun maxBounded(list: List<Int>, upperBound: Int, lowerBound: Int): Int { 
var currentMax = lowerBound 
forEach(list) { i -> 
when { 
i: > upperBound -> Return up upperBound 
a eunnantMau ~ e/ 


[RETURN NOT. ALLOWED] 'return' is not allowed here 





) 
return currentMax 


图 5.6 
有 具体 原因 与 代码 的 编译 方式 有 关 。 如 前 所 述 ，Lambda 表达 式 编 译 为 匿名 对 象 类 ， 其 中 包 
含 了 代码 定义 的 方法 。 由 于 处 于 不 同 的 上 下 文 环境 中 ， 因 而 无 法 从 maxBounded 函数 中 返回 。 
当 遇 到 forEach avian inline 这 种 情况 时 ， 之 前 也 曾 谈 到 ， 函 数 体 将 在 编译 时 蔡 换 
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调用 ,参数 中 的 全 部 函数 将 利用 对 应 的 代码 体 予以 蔡 换 。 因 此 ， 此 处 使 月 


s4694 





H return 修饰 符 并 





无 问题 。 随 后 ， 若 forEach 为 inline， 则 可 在 Lambda 表达 式 内 部 使 用 retum， 如 下 所 示 : 


inline fun forEach(list: List«Int», body: (Int)-»Unit) 


for(i in list) body(i) 
} 


fun maxBounded (list: List<Int>, upperBound: Int, 
lowerBound: Int): Int { 
var currentMax = lowerBound 
forEach(list) { i -> 
when ( 
i » upperBound -» return upperBound 
i » currentMax -> currentMax = i 
} 
} 
return currentMax 
} 


这 也 体现 了 Kotlin 中 maxBounded 函数 的 编译 方式 ; 当 反 编 译 至 Java 后 (经 过 适当 简化 )， 


对 应 代码 如 下 所 示 : 


public static final int maxBounded(@NotNull List list, 


int upperBound, int lowerBound) ( 
int currentMax = lowerBound; 
Iterator iter = list.iterator(): 
while(iter.hasNext()) ( 
int i = ((Number)iter.next()).intValue(); 
if(i » upperBound) ( 
return upperBound; // 1 
H 


if(i » currentMax) ( 
currentMax = i; 
) 
) 


return currentMax; 
} 











数 中 返回 。 
inline 函数 的 Lambda 表达 式 中 的 return 修饰 符 称 作 非 本 地 返回 








在 上 述 代码 中 ,retum 十 分 重要 一 一 该 语句 定义 于 Lambda KERF, JEFA maxBounded K 
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5.11.3 Lambda 表达 式 中 的 标记 返回 
下 面 考察 Lambda 表达 式 〈 而 非 函数 ) 中 的 返回 。 对 此 ， 可 使 用 标记 实现 这 一 任务 。 









































基于 标记 的 Lambda 表达 式 返回 如 下 所 示 : 





inline fun «T» forEach(list: List<T>, body: (T) -» Unit) ( // 1 
for (i in list) body(i) 
) 


fun printMessageButNotError (messages: List<String>) { 
forEach(messages) messageProcessor@ { // 2 
if (it == "ERROR") return@messageProcessor // 3 
print (it) 


} 
// Usage 


val list = listOf("A", "ERROR", "B", "ERROR", "C") 
processMessageButNotError(list) // Prints: ABC 


注释 1 可 视 为 forEach 函数 的 通用 实现 ， 其 中 可 处 理 包 含 任意 类 型 的 列表 。 在 注释 2 中 ， 
则 在 forEach 参数 中 针对 Lambda 表达 式 定 义 标记 。 注 释 3 则 从 标记 指定 的 Lambda 表达 式 
中 返回 。 





Kotlin 的 另 一 个 特性 是 ， 定 义 为 函数 参数 的 Lambda 表达 式 包含 默 认 标记 ， 其 名 称 等 


同 于 其 中 所 定义 的 函数 。 相 应 地 ， 该 标记 称 作 隐 式 标记 。 当 需要 从 定义 在 forEach 函数 中 
的 Lambda 表达 式 中 返回 时 ， 可 使 用 retum@forEach 完成 这 一 操作 。 对 应 示例 如 下 所 示 : 


inline fun «T» forEach(list: List<T>, body: (T) -> Unit) ( // 1 
for (i in list) body(i) 
) 


fun processMessageButNotError (messages: List<String>) { 
forEach (messages) { 
if (it == "ERROR") return@forEach // 1 
process (it) 


} 
// Usage 


val list = listOf("A", "ERROR", "B", "ERROR", "C") 
processMessageButNotError(list) // Prints: ABC 
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在 注释 1 中 ， 隐 式 标记 名 从 函数 名 中 获取 。 
注意 ， 虽 然 forEach 为 inline， 但 还 可 使 用 非 本 地 返回 ， 进 而 从 processMessageButNotError 


函数 中 返回 ， 如 下 所 示 : 


inline fun «T» forEach(list: List<T>, body: (T) -> Unit) ( 





} 


fun 


) 














for (i in list) body(i) 


processMessageButNotError (messages: List<String>) { 
forEach(messages) { 

if (it == "ERROR") return 

process (it) 


// Usage 


val 


list = listof("A", "ERROR", "B", "ERROR", "C") 


processMessageButNotError(list) // Prints: A 





下 














考察 使 用 本 地 返回 标记 的 更 为 复杂 的 示例 。 假 设 包含 两 个 forEach 循环 ， 且 一 个 


循环 位 于 另 一 个 循环 中 。 当 使 用 隐 式 标记 时 ， 将 从 更 深 的 循环 中 返回 。 在 当前 示例 中 ， 可 
采用 这 一 方式 ， 并 忽略 特定 消息 的 处 理 过 程 ， 如 下 所 示 : 


inline fun <T> forEach(list: List<T>, body: (T) -> Unit) { // 1 


) 


fun 





for (i in list) body(i) 


processMessageButNotError(conversations: List<List<String>>) { 
forEach(conversations) { messages -> 


forEach(messages) { 
if (it == "ERROR") return@forEach // 1. 


process (it) 


// Usage 
val conversations = listof( 


) 


listOf("A", "ERROR", "B"), 
listOf("ERROR", "C"), 
listof ("D") 


processMessageButNotError(conversations) // ABCD 
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n 


在 注释 1 中 ， 将 从 定义 在 forEach 函数 〈 该 函数 接收 消息 作为 参数 ) 中 的 Lambda 返回 。 
在 使 用 隐 式 标记 的 同一 上 下 文中 ， 无 法 从 另 一 个 Lambda ik St PAK 畜 标 记 位 
于 更 深 的 隐 式 标记 下 。 
在 此 类 情形 中 ， 需 要 使 用 非 本 地 隐 式 标记 返回 ， 在 当前 示例 
中 ， 虽 然 foEach 为 内 联 函数 ， 但 可 通过 下 列 方式 从 函数 字面 值 中 返 


inline fun «T» forEach(list: List«T», body: (T) -> Unit) ( // 1 
for (i in list) body(i) 









































) 


fun processMessageButNotError (conversations: List<List<String>>) { 
forEach(conversations) conv@ { messages -> 
forEach(messages) { 
if (it == "ERROR") return@conv // 1. 
print (it) 


) 


// Usage 

val conversations = listof( 
listOf("A", "ERROR", "B"), 
listOf("ERROR", "C"), 
listof ("D") 

) 


processMessageButNotError(conversations) // AD 
针对 注释 1， 将 从 定义 于 forEach 中 的 Lambda 返回 。 
除 此 之 外 ， 还 可 使 用 非 本 地 返回 〈 不 包含 任何 标记 的 返回 ) 结束 当前 处 理 过 程 ， 如 下 
所 示 : 
inline fun «T» forEach(list: List<T>, body: (T) -> Unit) ( // 1 
for (i in list) body(i) 














} 


fun processMessageButNotError (conversations: List<List<String>>) { 
forEach (conversations) { messages -> 
forEach (messages) { 
if (it == "ERROR") return // 1. 
process (it) 
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对 于 注释 1， 这 将 从 processMessageButNotError 函数 中 返回 ， 并 结束 当前 处 理 过 程 。 





5.11.4 crossinline 修饰 符 


某 些 时 候 ， 需 要 从 内 联 函 数 〈 未 直接 位 于 函数 体 中 ) 中 使 用 函数 类 型 参数 ， 但 位 于 另 
一 个 执行 环境 中 ， 例 如 本 地 对 象 或 嵌 套 函数 。 但 是 ， 由 于 支持 非 本 地 返回 ， 内 联 函 数 的 标 
准 函数 类 型 参数 不 允许 通过 这 种 方式 加 以 使 用 ;如 果 该 函数 可 在 另 一 个 执行 环境 下 使 用 ， 
则 应 予以 禁用 。 为 了 通知 编译 器 非 本 地 返回 禁用 ， 对 应 参数 须 标记 为 crossinline。 随 后 ， 
即 可 在 inline 函数 中 实现 替代 作用 ， 甚 至 可 在 另 一 个 Lambda 表达 式 中 使 用 ， 如 下 所 示 : 
fun boo(f: () -> Unit) ( 


Mose 
) 

































































inline fun foo(crossinline f: () -> Unit) ( 
boo ( println("A"); f() ) 
) 


fun main(args: Array<String>) { 
foo { println("B") } 
) 
这 将 编译 为 下 列 内 容 : 
fun main(args: Array<String>) ( 
boo { println("A"); println("B") } 
) 
虽然 利用 该 函数 并 未 生成 属性 ， 但 不 可 将 crossinline 参数 作为 参数 传递 至 另 一 个 函数 中 ， 
如 图 5.7 所 示 。 


1 inline fun foo(crossinline f: () -> Unit) { 














| Illegal usage of inline-parameter 'f' in ‘public inline fun foo(crossinline f: 0 -> Unit): Unit defined in demo’. Add 'noinline' modifier to the parameter declaration 





图 5.7 


下 面 考察 Android 中 的 实际 用 例 。 由 于 可 使 用 Looper 类 中 的 getMainLooper 静态 函数 
获得 主 循环 ， 因 而 无 须 Context 执行 主 应 用 程序 线程 上 的 操作 。 因 此 ， 可 编写 顶级 函数 ， 
并 将 单线 程 调整 为 主线 程 。 为 了 对 此 进行 优化 ， 首 先 检查 当前 线程 是 否 为 主线 程 。 若 是 ， 
则 调用 相关 操作 ;否则 ， 生 成 一 个 处 理 程序 ， 在 主线 程 和 后 处 理 中 执行 操作 ， 并 调用 该 处 理 
程序 。 为 了 提高 该 函数 的 执行 速度 ， 应 将 mnOnUiThread 函数 定义 为 inline， 并 于 随后 从 另 
一 个 线程 中 执行 操作 调用 ， 对 此 需要 将 其 设置 为 crossinline。 函 数 的 实现 过 程 如 下 所 示 : 
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inline fun runOnUiThread(crossinline action: () -> Unit) ( 
val mainLooper = Looper.getMainLooper () 


if (Looper.myLooper() -- mainLooper) ( 
action() 
) else ( 


Handler (mainLooper) .post ( action() ) // 1 
} 
) 


针对 注释 1， 鉴 于 crossinline， 因 而 可 在 Lambda 表达 式 中 运行 action。 
由 于 可 在 Lambda 表达 式 或 本 地 函数 上 下 文中 使 用 函数 类 型 ， 同 时 保留 inline 函数 的 优点 
(在 该 上 下 文 环境 下 ， 无 须 创建 Lambda)， 因 而 crossinline 十 分 有 用 。 


5.11.5 inline 属性 





























É Kotlin 1.1 起 ，inline 修饰 符 可 用 于 相关 属性 上 (无 须 包含 幕后 字段 )。inline 修饰 符 
可 应 用 于 单一 访问 器 上 ， 以 使 代码 体 被 蔡 换 ， 或 者 还 可 用 于 整体 属性 上 ， 其 结果 等 同 于 将 
两 个 访问 器 定义 为 inline。 下 面 设 置 inline 属性 ， 用 于 检测 和 修改 元 素 的 可 见 性 。 其 中 ,两 
个 访问 器 均 为 inline， 其 实现 过 程 如 下 所 示 : 


var viewIsVisible: Boolean 
inline get() = findViewById(R.id.view).visibility == View.VISIBLE 
inline set(value) ( 
findViewById(R.id.view).visibility = if (value) View.VISIBLE 
else View.GONE 
) 


如 果 将 整体 属性 标记 为 inline， 则 可 获得 相同 结果 ， 如 下 所 示 : 


inline var viewIsVisible: Boolean 
get() = findViewById(R.id.view).visibility == View.VISIBLE 
set(value) ( 
indViewById(R.id.view).visibility = if (value) View.VISIBLE 
else View.GONE 
} 























// Usage 
if (!viewIsVisible) 
viewIsVisible = true 


上 述 代码 可 编译 为 下 列 结果 : 


if (!(findViewById(R.id.view).getVisibility() == View.VISIBLE) 
t 
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findViewById(R.id.view).setVisibility (true?View.VISIBLE:View.GONE); 
l 


通过 这 一 方式 , 可 忽略 set 和 get 方法 调用 , 并 在 增加 编译 代码 尺寸 的 前 提 下 提升 操作 
性 能 。 对 于 大 多 数 属性 ， 使 用 inline 修饰 符 依 然 可 获得 较 大 收益 。 





5.12 函数 引用 





某 些 时 候 ， 需 要 作为 参数 传递 的 函数 已 经 定义 为 独立 的 函数 。 随 后 ， 则 可 通过 其 调 月 
定义 Lambda， 如 下 所 示 : 


fun isOdd(i: Int) = i $ 2 == 1 








E] 





list.filter ( isodd(it) } 

在 Kotlin 中 ， 函 数 可 作为 值 进行 传递 。 为 了 将 顶级 函数 用 作 某 个 值 ， 需 要 使 用 到 函数 
引用 ， 即 使 用 两 个 冒号 以 及 函数 名 〔 形 如 ::functionName)。 下 列 代码 显示 了 其 应 用 方式 ， 
进而 提供 断言 以 执行 过 滤 操 作 : 
list.filter(::isOdd) 

对 应 示例 如 下 所 示 : 


fun greet()( 
print("Hello! ") 


















































) 


fun salute() { 
print ("Have a nice day ") 
} 


val todoList: List<() -> Unit> = listOf(::greet, ::salute) 


for (task in todoList) { 
task () 
j 


// Prints: Hello! Have a nice day 


函数 引用 可 视 作 反射 机 制 的 一 个 示例 ， 因 此 ， 该 操作 返回 的 对 象 同样 包含 了 与 引用 函数 相 
关 的 信息 ， 如 下 所 示 : 


fun isOdd(i: Int) = I $ 2 = 1 
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val annotations = ::isOdd.annotations 
val parameters = ::isOdd.parameters 

println(annotations.size) // Prints: 0 
println(parameters.size) // Prints: 1 


此 处 ， 该 对 象 还 实现 了 函数 类 型 ， 并 可 通过 下 列 方式 加 以 使 
val predicate: (Int)->Boolean = ::isOdd 


另外 ， 还 可 对 方法 加 以 引用 。 对 此 ， 须 编写 类 型 名 、 两 个 冒号 以 及 方法 名 《〈 形 如 
Type::functionName)， 对 应 示例 如 下 所 示 : 








au 








val isStringEmpty: (String)->Boolean = String::isEmpty 


// Usage 

val nonEmpty = listOf("A", "", "p", "") 

.filter(String::isNotEmpty) 

print(nonEmpty) // Prints: ["A", "B"] 
在 上 述 示例 中 ， 当 引用 非 静态 方法 时 ， 须 提供 类 实例 作为 参数 。 相 应 地 ，isEmpty 函数 定 
SON Suing 方法 ， 且 未 接收 任何 参数 。isEmpty 引用 则 包含 一 个 Sting 参数 ， 并 用 作 函 数 
调用 上 的 一 个 对 象 。 该 对 象 的 引用 通常 位 于 第 一 个 参数 。 下 列 代码 显示 了 另 一 个 示例 ， 其 
中 ， 对 应 方法 包含 了 已 经 定义 的 food 属性 : 


class User ( 























fun wantToEat (food: Food): Boolean { 
We eee 
} 
} 


val func: (User, Food) -> Boolean = User::wantToEat 


当 引 用 Java 中 的 静态 方法 时 ,情况 则 有 所 不 同 ， 其 原因 在 于 : 此 处 并 不 需要 使 用 到 
类 实例 。 这 类 似 于 对 象 方法 ， 或 者 伴生 对 象 。 其 中 ， 对 象 事先 已 知 且 无 须 提供 该 对 象 。 
此 时 ， 存 在 一 个 与 引用 函数 相同 的 参数 ， 以 及 相同 返回 类 型 生成 的 函数 ， 如 下 所 示 : 
object MathHelpers { 
fun isEven(i: Int) = i $ 2 = 0 
































} 


class Math { 
companion object { 
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fun isOdd(i: Int) =i % 2 == 1 
} 


// Usage 
val evenPredicate: (Int)->Boolean = MathHelpers::isEven 
val oddPredicate: (Int)->Boolean = Math.Companion::isOdd 


val numbers = 1..10 

val even = numbers.filter(evenPredicate) 
val odd = numbers.filter(oddPredicate) 
println(even) // Prints: [2, 4, 6, 8, 10] 
println(odd) // Prints: [1, 3, 5, 7, 9 


在 使 用 函数 引用 时 ， 存 在 一 类 常见 用 例 ， 其 中 ， 需 要 使 用 函数 引用 ， 并 从 所 引用 
的 某 个 类 中 提供 相关 方法 。 例 如 ， 当 需要 获取 某 些 操作 作为 同一 类 中 的 方法 时 ， 或 者 
需要 从 引用 成 员 函 数 〈 源 自 所 引用 的 类 ) 引用 函数 时 。 另 外 一 个 简单 的 示例 是 ， 网 络 
操作 后 所 执行 的 任务 。 对 应 内 容 定义 在 某 个 Presenter 中 (例如 MainPresenter), 但 引用 
了 全 部 View 操作 ， 并 通过 view 属性 加 以 定义 〈 例 如 MainView 类 型 )， 如 下 所 示 : 
getUsers().smartSubscribe ( 
onStart = ( view.showProgress() }, // 1 
onNext = ( user -> onUsersLoaded(user) }, // 2 


onError = ( view.displayError(it) }, // 1 
onFinish - ( view.hideProgress() ) // 1 












































) 
针对 注释 1, showProgress, displayError 以 及 hideProgress 均 定义 于 MainView 中 ; 针对 注 
释 2，onUsersLoaded 表示 为 定义 于 MainPresenter 中 的 方法 。 
针对 于 此 ，Kotlin 自 版 本 1.1 后 引入 了 绑 定 引用 (bound references)， 并 提供 了 与 特定 
类 绑 定 的 引用 。 据 此 ， 该 对 象 无 须 通过 某 个 参数 予以 提供 。 当 使 用 这 一 标记 时 ， 可 通过 下 
列 方式 替换 之 前 的 定义 ， 如 下 所 示 : 
getUsers().smartSubscribe ( 
onStart = view::showProgress, 
onNext = this::onUsersLoaded, 


onError — view::displayError, 
onFinish = view::hideProgress 














) 
另 一 个 需要 引用 的 函数 则 是 构造 函数 。 例 如 ， 从 数据 传输 对 象 CDTO) 映射 至 模型 中 
的 某 个 类 ， 如 下 所 示 : 
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fun toUsers(usersDto: List«UserDto») = usersDto.map ( User(it) } 


此 处 ， 用 户 需要 包含 一 个 构造 函数 ， 并 定义 了 基于 UserDto 的 构造 方式 。 


DIO 表示 为 一 个 对 象 ， 并 加 载 进程 间 的 数据 ， 其 用 途 主要 是 因为 : 某 
0 个 系统 ( 位 于 API 中 ) 间 通信 过 程 中 所 使 用 的 类 一 般 不 同 于 当前 系统 ( 模型 ) 
内 部 所 用 的 实际 类 。 
在 Kotlin 中 , 构造 函数 视 为 与 函数 类 似 。 另 外, 还 可 采用 双 冒 号 和 类 名 对 其 加 以 引用 ， 
如 下 所 示 : 
val mapper: (UserDto)->User = ::User 
通过 这 种 方式 ， 可 利用 包含 构造 函数 引用 的 某 个 构造 函数 调用 替换 Lambda， 如 下 所 示 : 
fun toUsers(usersDto: List«UserDto») = usersDto.map(::User) 
使 用 函数 引用 而 非 Lambda 表达 式 可 生成 简短 且 兼 具 可 读 性 的 标记 。 当 作为 参数 传递 


多 个 函数 时 ， 该 方法 万 为 有 效 。 在 其 他 情况 下 ， 绑 定 引 用 也 十 分 有 用 ， 并 可 提供 与 特定 对 
象 绑 定 的 引用 。 














au 
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本 章 讨论 了 作为 “第 一 公民 ”的 函数 ， 函 数字 面值 〈 匿 名 类 和 Lambda 表达 式 ) 的 定 
义 方式 ， 以 及 在 函数 引用 这 一 前 提 下 ， 任 意 函 数 均 可 用 作对 象 这 一 概念 。 另 外 ， 本 章 还 介 
绍 了 高 阶 函 数 ， 以 及 Kotlin 对 此 予以 支持 的 各 种 特性 ， 包 括 单一 参数 的 隐 式 名 称 、 参 数 规 
则 中 的 最 后 一 个 Lambda、Java SAM 支持 、 未 用 变量 的 下 划 线 使 用 ， 以 及 Lambda 表达 式 
中 的 解构 声明 。 此 类 特性 针对 高 阶 函数 提供 了 极 大 的 支持 ， 并 进一步 丰富 了 函数 的 内 容 。 

第 6 章 将 讨论 Kotlin 中 的 通用 型 任务 ， 其 中 涉及 功能 强大 的 类 和 函数 。 除 此 之 外 ， 还 
将 探讨 与 高 阶 函 数 结合 使 用 时 ， 相 关 类 和 函数 的 应 用 方式 。 











第 6 章 泛 


第 5 章 讨论 了 函数 编程 ， 以 及 作为 “一 等 公民 ”的 函数 方 
本 章 将 介绍 泛 型 和 泛 型 函数 等 概念 ， 并 考察 其 存在 的 原 


型 














因 和 有 





面 的 概念 。 


应 用 方式 ， 包 括 定义 泛 型 


类 、 接 口 和 函数 。 另 外 ， 本 章 还 将 探讨 运行 期 内 泛 型 的 处 理 方式 、 子 类 型 关系 以 及 泛 型 可 
空 类 型 。 


案 : 
的 、 


本 章 主 要 涉及 以 下 内 容 : 
e iz), 

e 泛 型 接口 。 
e 江 型 函数 。 
e 泛 型 约束 条 件 。 

e 泛 型 可 空 类 型 。 

e 变型 。 

e 使 用 点 变型 和 声明 点 变型 。 
e 声明 点 目标 。 

e 类 型 擦 除 (type erasure). 
e 具体 化 和 擦 除 类 型 参数 。 
e 星 号 投射 语法 。 
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泛 型 是 一 种 编程 风格 ， 其 中 ， 类 、 函 数 、 数 据 结构 或 者 算法 的 编写 方式 采用 了 如 下 方 
实际 类 型 于 稍 后 指定 。 总 体 而 言 ， 泛 型 提供 了 类 型 安全 特性 ， 以 及 针对 各 种 数据 类 型 


特定 代码 结构 的 复 用 行为 。 


Java 和 Kotlin 均 对 泛 型 提供 了 支持 ， 其 工作 方式 也 较为 类 似 。 但 相对 于 Java，Kotlin 
提供 了 一 些 改进 措施 ， 例 如 使 用 位 置 变异 、 星 号 投射 语法 ， 以 及 具体 化 类 型 参数 。 本 章 将 
对 此 加 以 讨论 。 
程序 员 常 常 需要 一 种 方式 指定 包含 某 种 特定 类 型 的 集合 , 例如 Int. Student 或 Car。 如 
果 未 使 用 泛 型 ， 则 需要 针对 各 个 数据 类 型 (IntList、StudentList 以 及 CarList 等 ) 单独 定义 
相关 类 ， 这 些 类 包含 类 似 的 内 部 实现 ， 仅 存储 的 数据 类 型 有 所 不 同 。 这 意味 着 ， 我 们 需要 
多 次 编写 相同 的 代码 (例如 从 集合 中 添加 或 删除 数据 项 )， 并 单独 维护 各 个 类 。 鉴 于 工作 
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量 较 大 ， 因 此 ， 在 泛 型 出 现 以 前 ， 程 序 员 一 般 需 要 对 通用 列表 进行 操作 ， 并 在 每 次 访问 时 
对 数据 进行 类 型 转换 ， 如 下 所 示 : 

// Java 

ArrayList list = new ArrayList(); 

list.add(1); 

list.add(2); 

int first = (int) list.get(0); 

int second - (int) list.get(1); 

类 型 转换 可 视 作 是 一 类 样板 操作 ， 当 某 个 数据 元 素 添加 至 集合 时 ， 并 不 存在 相应 的 类 
型 验证 机 制 。 针 对 于 此 ， 泛 型 给 出 了 解决 方案 一 一 泛 型 类 定义 并 使 用 了 占 位 符 而 非 实 际 类 
型 ， 该 占 位 符 称 作 类 型 参数 。 下 面 定义 第 一 个 泛 型 类 ， 如 下 所 示 : 


class SimpleList<T> // T is type parameter 


类 型 参数 表示 当前 类 将 使 用 特定 类 型 , 但 对 应 类 型 将 在 类 构建 时 指定 。 通 过 这 种 方式 ， 
可 针对 各 种 类 型 实例 化 SimpleList 类 。 利 用 类 型 参数 ， 可 对 包含 各 种 数据 类 型 的 泛 型 类 实 
现 参数 化 操作 ， 并 可 从 单一 类 中 创建 多 种 数据 类 型 ， 如 下 所 示 : 

// Usage 

var intList: SimpleList«Int» 

var studentList: SimpleList«Student» 

var carList:SimpleList<Car> 
SimpleList 类 利用 类 型 参数 Cnt. Student 以 及 Car) 进行 参数 化 ， 进 而 定义 了 存储 于 既定 
列表 中 的 数据 类 型 。 

函数 包含 了 形式 参数 (函数 声明 中 的 变量 ) 以 及 实际 参数 (传递 至 函数 中 的 实际 参数 )， 
类 似 技术 也 可 以 应 用 于 泛 型 中 。 针 对 泛 型 中 声明 的 类 型 ， 类 型 形 参 表示 为 一 个 蓝本 或 占 位 
符 ， 而 类 型 实 参 则 表示 用 于 参数 化 某 个 泛 型 的 实际 类 型 。 

在 方法 签名 中 可 使 用 类 型 形 参 ， 据 此 ， 可 确保 向 列表 中 添加 特定 类 型 的 数据 项 ， 并 从 
特定 类 型 中 获取 数据 项 ， 如 下 所 示 : 


class SimpleList<T> { 









































fun add(item:T) ( // 1 
// code 
} 
fun get(intex: Int): T ( //2 
// code 
l 
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针对 注释 1， 泛 型 参数 了 用 作 数 据 项 类 型 ， 在 注释 2 中 ， 类 型 参数 用 作 返 回 类 型 。 

根据 类 型 实 参 ， 可 向 列表 中 添加 数据 项 ， 或 者 从 列表 中 获取 数据 项 ， 相 关 示 例如 下 
所 示 : 

class Student(val name: String) 

val studentList = SimpleList<Student>() 

studentList.add (Student ("Ted") ) 

println(studentList.getItemAt (0) .name) 

从 当前 列表 中 ， 可 添加 或 获取 类 型 为 Student 的 数据 项 。 编 译 器 将 自动 执行 所 有 必需 
的 类 型 检测 ， 确 保 集合 仅 包含 特定 类 型 的 对 象 。 另 外 ， 向 add 方法 中 传递 不 兼容 类 型 的 对 
象 将 产生 编译 期 错误 ， 如 下 所 示 : 

var studentList: SimpleList<student> 


studentList.add (Student ("Ted") ) 
studentList.add(true) // error 


鉴于 期 望 类 型 为 Student， 因 而 无 法 加 入 Boolean 类 型 。 


@ Kotlin 标准 库 在 kotlin.collections 包 中 定义 了 各 种 泛 型 集合 ， 例 如 List、 
Set 以 及 Map， 第 7 章 将 对 此 深入 讨论 。 

















在 Kotlin 中 ， 泛 型 常 与 高 阶 函数 (参见 第 5 章 ) 以 及 扩展 函数 〈 参 见 第 7 章 ) 结合 使 
目 ， 相 关 示 例 包 括 map. filter 以 及 takeUntil 等 函数 ， 并 可 执行 包含 细节 差异 的 各 种 常见 
操作 。 例 如 ， 利 用 filter 函数 在 集合 中 查找 匹配 元 素 ， 以 及 指定 匹配 元 素 间 的 检测 方式 ， 
如 下 所 示 : 

val fruits = listOf("Babana", "Orange", "Apple", "Blueberry" 

val bFruits = fruits.filter ( it.startsWith("B") ) //1 

println(bFruits) // Prints: [Babana, Blueberry] 
针对 注释 1， 可 调用 startsWith 方法 ， 其 原因 在 于 ， 集 合 仅 包含 Strings， 因 而 Lambda 参数 
GO 包含 相同 类 型 。 























62 泛 型 约束 条 件 





默认 条 件 下 ， 可 利用 任何 类 型 参数 对 泛 型 类 进行 参数 化 ， 但 还 是 需要 对 其 予以 适当 限 
制 。 当 限定 类 型 参数 的 可 能 值 时 ， 需 要 定义 类 型 参数 约束 (bound)。 其 中 ， 较 为 常见 的 约 
束 类 型 则 是 上 限 约束 。 默 认 状态 下 ， 全 部 类 型 参数 均 包 含 Any? 作 为 隐 式 上 限 。 因 此 ， 下 
列 两 项 声明 彼此 等 价 : 
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class SimpleList<T> 
class SimpleList«T: Any?» 





上 述 约 束 表明 ， 针 对 SimpleList 类 (包括 可 空 类 型 )， 可 采用 任意 所 需 类 型 作为 类 型 参 
数 一 全 部 可 空 或 非 空 类 型 均 为 Any? 的 子 类 型 ， 如 下 所 示 : 


» 


Hy 





class SimpleList<T> 
class Student 
// usage 


var intList = SimpleList<Int>() 

var studentList = SimpleList«Student»() 

var carList - SimpleList«Boolean»() 

在 某 些 场合 下 ， 须 限制 用 作 类 型 参数 的 数据 类 型 。 对 此 ， 须 显 式 定义 类 型 参数 上 限 约 
针对 SimpleList 类 ， 此 处 假设 仅 须 使 用 数字 类 型 作为 类 型 参数 ， 如 下 所 示 : 

class SimpleList<T: Number> 

// usage 





var numberList = SimpleList<Number> () 

var intList = SimpleList<Int>() 

var doubleList = SimpleList<Double>() 

var stringList = SimpleList«String»() //error 


P. Number 表示 为 抽象 类 ， 即 Kotlin 数字 类 型 (Byte, Short, Int, Long, Float 以 及 


Double) 的 超 类 ， 并 可 将 Number 类 及 其 全 部 子 类 Cnt. Double 等 ) 用 作 类 型 参数 ， 但 却 
无 法 使 用 String 类 一 一 该 类 并 非 是 Number 的 子 类 。IDE 以 及 编译 器 将 视 这 一 类 不 兼容 类 
型 为 错误 。 另 外 ， 类 型 参数 还 可 与 Kotlin 可 空 类 型 进行 整合 。 


当 定 义 包 含 非 约束 类 型 参数 的 某 个 类 时 ， 可 采用 非 空 和 可 空 类 型 作为 类 型 参数 。 少 数 


时 候 , 还 须 确保 特定 泛 型 不 被 可 空 类 型 参数 进行 参数 化 。 为 了 禁用 可 空 类 型 作为 类 型 参数 ， 
需要 显 式 地 定义 非 空 类 型 参数 上 限 约 束 ， 如 下 所 示 : 


Hy 


class Action (val name:String) 
class ActionGroup<T : Action> 


// non-nullable type parameter upper bound 


var actionGroupA: ActionGroup<Action> 
var actionGroupB: ActionGroup<Action?> // Error 


PF， 不 可 向 ActionGroup 类 传递 可 空 类 型 参数 (Action? )。 
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下 面 考察 另 一 个 示例 。 假 设 需要 获取 ActionGroup 中 最 后 一 个 Action， 下 列 代码 简单 
地 定义 了 last 方法 。 
class ActionGroup<T : Action>(private val list: List<T>) { 
fun last(): T = list.last() 








) 
当 向 构造 函数 传递 一 个 空 表 时 ， 具 体 情 况 如 下 所 示 : 


val actionGroup = ActionGroup«Action» (listof ()) 


Wiss 
val action = actionGroup.last 
// error: NoSuchElementException: List is empty 


println (action.name) 
于 不 存在 包含 该 列表 索引 的 元 素 ，last 方法 将 抛 出 一 个 错误 。 相 比 于 异常 ， 当 列表 
为 空 时 ， 可 优先 选用 null 值 。Kotlin 标准 库 中 已 定义 了 一 个 对 应 的 方法 ， 并 返回 null 值 ， 
如 下 所 示 : 
class ActionGroup<T : Action> (private val list: List<T>) { 
fun lastOrNull(): T = list.lastOrNull() //error 

) 
鉴于 最 后 一 个 方法 将 返回 null (列表 中 不 存在 可 返回 的 元 素 )， 因 而 上 述 代码 无 法 被 编译 。 
为 了 解决 此 类 问题 , 须 强制 执行 可 空 返 回 类 型 , 即 向 类 型 参数 使 用 位 置 添加 一 个 问号 (T? )， 
如 下 所 示 : 

class ActionGroup<T : Action> (private val list: List<T>) ( // 1 

fun lastOrNull(): T? - list.lastOrNull() // 2 

) 

对 于 注释 1， 表 示 为 类 型 参数 使 用 位 置 ( 将 代码 置 于 类 型 参数 声明 处 )， 对 于 注释 2， 表 示 
为 类 型 参数 使 用 位 置 〈 将 代码 置 于 类 型 参数 使 用 处 )。 

T? 参 数 表示 ，lastOrNull 应 一 直 保持 可 空 ， 且 无 须 考虑 潜在 的 类 型 参数 可 空 性 。 需 要 
注意 的 是 ， 由 于 需要 存储 非 空 类 型 ， 并 仅 对 特定 场合 〈 例 如 最 后 一 个 元 素 不 存在 ) 处 理 可 
空 性 , 因而 可 将 类 型 参数 T 约束 恢复 为 非 空 类 型 Action。 随后 可 使 用 更 新 后 的 ActionGroup 
类 ， 如 下 所 示 : 


val actionGroup- ActionGroup<Action> (listOf () ) 
val actionGroup = actionGroup.lastOrNull() 
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// Inferred type is Action? 
println(actionGroup?.name) // Prints: null 
注意 ，actionGroup 推断 类 型 为 可 空 型 ， 即 使 利用 非 空 类 型 参数 实现 了 泛 型 的 参数 化 。 
使 用 位 置 处 的 可 空 类 型 并 不 妨碍 在 声明 位 置 使 用 非 空 类 型 ， 如 下 所 示 : 
open class Rction 
class ActionGroup<T : Action?>(private val list: List<T>) ( 


fun lastOrNull(): T? = list.lastOrNull() 
) 


// Usage 

val actionGroup = ActionGroup(listOf(Action(), null)) 

println(actionGroup.lastOrNull()) // Prints: null 

综 上 所 述 ， 可 针对 类 型 参数 指定 非 空 约束 ， 以 禁止 ActionGroup 类 的 参数 化 操作 〈 利 
日 可 空 类 型 作为 类 型 参数 )。 同 时 ， 可 通过 非 空 类 型 参数 Action 对 ActionGroup 类 进行 参 
数 化 。 最 后 ， 若 列表 中 不 存在 元 素 ， 最 后 一 个 属性 可 返回 null， 因 而 可 在 使 用 位 置 处 强制 
执行 类 型 参数 的 可 空 性 (T?) 
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子 类 型 是 OOP 编程 中 的 一 个 常见 概念 ， 通 过 扩展 类 ， 可 在 两 个 类 之 间 定义 继承 机 制 ， 
如 下 所 示 : 


open class Animal(val name: String) 
class Dog(name: String): Animal (name) 
类 Dog 扩展 了 Animal 类 ， 因 而 类 型 Dog 表示 为 Animal 的 子 类 型 。 这 表明 ， 当 需要 
使 用 到 类 型 Animal 的 表达 式 时 ， 可 使 用 Dog 类 型 。 例 如 ， 可 将 其 作为 函数 参数 ， 或 者 将 
Dog 类 型 变量 赋予 Animal 类 型 变量 ， 如 下 所 示 : 
fun present(animal: Animal) ( 
println( "This is $( animal. name } " ) 
) 
present(Dog( "Pluto" )) // Prints: This is Pluto 
在 介绍 后 续 内 容 之 前 ， 首 先 需要 讨论 类 和 类 型 之 间 的 差异 。 这 里 ， 类 型 是 一 类 更 加 通 
的 术语 ， 可 通过 类 或 接口 定义 ， 或 者 为 语言 的 内 置 内 容 (基础 类 型 )。 在 Kotlin 中 ， 对 
于 各 个 类 (例如 Dog)， 至 少 包含 两 种 可 能 的 类 型 ， 即 非 空 (DOG) 和 可 空 类 型 (Dog? )。 
而 且 ， 对 于 各 个 泛 型 类 (例如 clas Box<T>)， 还 可 定义 多 个 数据 类 型 (Box<Dog>， 
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Box<Dog?>, Box<Animal>, Box-Box-Dog^^^$). 

上 述 示例 仅 使 用 了 简单 类 型 。 变 型 (型 变 ) 定义 了 复杂 类 型 间 子 类 型 (例如 Box<Dog> 
和 Box<Animal>) 与 组 件 间 子 类 型 (例如 Animal 和 Dog) 之 间 的 关系 方式 。 

在 Kotlin 中 ， 默 认 条 件 下 ， 泛 型 处 于 不 可 变 状态 ， 这 也 意味 着 ， 泛 型 Box<Dog> 和 
Box<Animal> 之 间 不 存在 子 类 型 关系 。Dog 组 件 表示 为 Animal 的 子 类 型 ， 但 Box<Dog> 并 
不 是 一 个 子 类 型 ， 同 时 也 并 非 是 Box<Animal> 的 子 类 型 ， 如 下 所 示 : 

class Box<T> 


open class Rnimal 
class Dog : Animal() 


var animalBox = Box<Animal>() 
var dogBox = Box<Dog>() 


// one of the lines below line must be commented out, 

// otherwise Android Studio will show only one error 

animalBox = dogBox // 2, error 

dogBox = animalBox // 1, error 
对 于 注释 1， 错 误 类 型 不 匹配 。 需 要 Box<Animal>， 实 际 为 Box<Dog>。 对 于 注释 2， 错 误 
类 型 不 匹配 ， 需 要 Box<Dog>， 实 际 为 Box<Animal>。 

Box<Dog> 类 型 即 非 子 类 型 ， 也 非 Box<Animal> 的 子 类 型 ， 因 此 无 法 使 用 代码 中 的 赋 
值 操 作 。 

对 此 ， 可 定义 Box<Dog> 和 Box<Animal> 之 间 的 子 类 型 关系 。 在 Kotlin 中 ， 泛 型 的 子 
类 型 关系 可 表示 为 协 变 、 逆 变 或 者 不 可 变 状 态 。 

若 子 类 型 关系 为 协 变 ， 则 表明 子 类 型 被 保留 。 泛 型 将 持 有 与 类 型 参数 相同 的 关系 。 若 
Dog 为 Animal 的 子 类 型 ， 那 么 Box<Dog> 则 表示 为 Box<Animal> 的 子 类 型 。 

逆 变 则 与 协 变相 反 ， 并 逆转 子 类 型 。 泛 型 相对 于 类 型 参数 具有 反 向 关系 。 若 Dog 表示 
为 Animal 的 子 类 型 ， 则 Box<Animal> 表 示 为 Box<Dog> 的 子 类 型 。 图 6.1 显示 了 全 部 变型 

















Covariant Contravariant Invariant 


Animal Box<Dog> Box<Animal> Box<Animal> 


| Dog | Box<Animal> 














| Box<Dog> | | Box<Dog> | 





图 6.1 
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当 定 义 协 变 或 逆 变 行为 时 ， 需 要 使 用 到 变型 修饰 符 。 
6.3.1 变型 修饰 符 








默认 条 件 下 ，Kotlin 中 的 变型 处 于 不 可 变 状态 ， 这 也 表明 ， 须 将 类 型 用 








作 声明 变量 或 





函数 参数 的 类 型 ， 如 下 所 示 : 


public class Box<T> ( } 
fun sum(list: Box«Number») ( /* ... */ } 


// Usage 

sum(Box<Any>()) // Error 
sum(Box«Number»()) // Ok 
sum(Box<Int>()) // Error 





此 处 不 可 使 用 基于 Int 的 参数 化 泛 型 (表示 为 Number 的 子 类 型 )， 也 不 可 使 用 基于 Any 
的 参数 化 泛 型 (表示 为 Number 的 超 类 型 )。 通 过 变型 修饰 符 ， 可 适当 放松 限制 ， 并 调整 某 
人 变型 。 在 Java 中 ， 问 号 标记 通配符 符号 ) 用 于 表示 未 知 类 型 。 据 此 ， 可 定义 两 种 通 配 








符 约束 类 型 , 即 上 界 约束 和 下 界 约束 。 在 Kotlin H, 可 通过 in 和 out 修饰 符 实 





名 类 似 的 行为 。 


在 Java 中 ， 上 约束 通配符 可 定义 接收 任意 参数 (其 子 类 型 的 特定 类 型 ) 的 函数 。 在 下 
列 示例 中 ，sum 函数 将 接收 任意 List， 该 List 利用 Number 类 或 Number 类 的 子 类 型 





(Box<Integer>，Box<Double> 等 ) 进行 参数 化 ， 如 下 所 示 : 


// Java 
public void sum(Box«? extends Number» list) ( /* ... */ } 


// Usage 

sum(new Box<Any>()) // Error 
sum(new Box<Number>()) // Ok 
sum(new Box<Int>()) // Ok 


此 处 ， 可 将 Box<Number> 传 递 至 sum 函数 以 及 全 部 子 类 型 中 ， 例 如 Box<Int>. 3X— Java 
操作 行为 对 应 于 Kotlin 的 out 修饰 符 ， 并 体现 了 协 变 行为 ， 同 时 将 当前 类 型 限定 为 特定 类 
型 或 当前 类 型 的 子 类 型 。 这 意味 着 ， 可 安全 地 传递 Box 类 实例 (利用 Number 的 直接 或 间 


接 子 类 )， 如 下 所 示 : 


class Box«T» 
fun sum(list: Box«out Number») ( /* ... */ } 


// usage 
sum(Box<Any>()) // Error 
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sum(Box«Number»()) // Ok 

sum(Box«Int»()) // Ok 

在 Java 中 ， 下 界 约束 通配符 可 定义 接收 任意 参数 (表示 为 特定 类 型 或 其 子 类 型 ) 的 函 
数 。 在 下 面 的 示例 中 ，sum 函数 接收 任意 List, 该 List 利用 Number 类 或 Number 类 的 超 类 
型 (Box<Number> 和 Box<Object>) 进行 参数 化 ， 如 下 所 示 : 


// Java 
public void sum(Box«? super Number» list) ( /* ... */ ) 





























// usage 

sum(new Box<Any>()) // Ok 

sum(new Box<Number>()) // Ok 

sum(new Box«Int»()) // Error 

当前 ， 可 向 sum 函数 以 及 全 部 子 类 型 传递 Box<Any>， 例 如 Box<Any>。 这 一 Java 操 
作 行为 对 应 于 Kotlin 中 的 in 操作 符 , 并 体现 了 逆 变 状态 ,同时 将 当前 类 型 限定 为 特定 类 型 
或 当前 类 型 的 超 类 型 ， 如 下 所 示 ; 

class Box«T» 

fun sum(list: Box<in Number») ( /* ... */ } 


// usage 

sum(Box«Any»()) // Ok 

sum(Box«Number»()) // Ok 

sum(Box«Int»()) // Error 

此 处 禁止 使 用 in 和 out 修饰 符 。 另 外 ， 可 通过 两 种 不 同方 式 定 义 变型 修饰 符 ， 稍 后 将 
对 此 加 以 讨论 。 


6.3.2 ”使 用 位 置 变型 和 声明 位 置 变型 
使 用 位 置 和 声明 位 置 变型 基本 上 描述 了 代码 的 位 置 ( 地 点 )， 其 中 指定 了 变型 修饰 符 。 
下 面 考察 View 和 Presenter 示例 ， 如 下 所 示 : 


interface BaseView 
interface ProductView : BaseView 
class Presenter<T> 





// Usage 

var preseter = Presenter<BaseView> () 

var productPresenter = Presenter<ProductView> () 
preseter = productPresenter 
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// Error: Type mismatch 
// Required: Presenter<BaseView> 
// Found: Presenter<ProductView> 


Presenter 在 其 类 型 parameterT 处 于 不 可 变 状 态 。 为 了 修正 这 一 问题 ， 可 显 式 地 定义 子 
类 型 关系 。 其 中 包括 两 种 方式 〈 使 用 点 和 声明 点 )。 下 面 首先 定义 使 用 点 处 的 变型 ， 如 下 
所 示 : 

var preseter: Presenter<out BaseView> = Presenter«BaseView»() //1 


var productPresenter = Presenter<ProductView> () 
preseter - productPresenter 


针对 注释 1， 变 型 修饰 符 在 类 型 参数 使 用 点 处 定义 了 变型 修饰 符 。 
当前 ，preseter 变量 可 存储 Presenter<BaseView> 的 子 类 型 ， 包 括 Presenter<ProductView>。 











当前 方案 可 正常 工作 ， 但 需要 对 其 实现 加 以 改进 。 该 方案 包含 两 个 问题 。 目 前 ， 在 每 次 使 
肯 泛 型 时 ， 均 需要 指定 out 变型 修饰 符 。 例 如 ， 在 不 同类 以 及 多 个 变量 中 对 其 加 以 使 用 ， 
如 下 所 示 : 


// Variable declared inside class A and class B 


























var preseter = Presenter<BaseView>() 

var preseter: Presenter<out BaseView» = Presenter<ProductView>() 

preseter = productPresenter 
类 A 和 B 包含 了 preseter 变量 (其 中 包含 了 变型 修饰 符 )。 这 里 暂时 无 法 使 用 类 型 推断 机 
制 ， 最 终 导致 代码 较为 元 长 。 为 了 对 此 加 以 改进 ， 须 在 类 型 参数 声明 点 处 指定 变型 修饰 符 ， 
如 下 所 示 : 

interface BaseView 


interface ProductView: BaseView 
class Presenter<out T> // 1 


// usage 
// Variable declared inside class A and B 


var preseter = Presenter«BaseView»() 

var productPresenter = Presenter<ProductView> () 

preseter - productPresenter 
对 于 注释 1， 变 型 修饰 符 在 类 型 参数 声明 位 置 处 定义 了 变型 修饰 符 。 

在 Presenter 类 中 ， 仅 须 定义 变型 修饰 符 一 次 。 实 际 上 ， 上 述 两 种 实现 彼此 等 价 ， 但 声 
明 位 置 变型 更 加 简洁 ， 同 时 还 可 被 类 的 外 部 客户 端 方便 地 加 以 使 用 。 
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6.33 ”集合 变型 


在 Java 中 ， 数 组 表示 为 协 变数 据 。 默 认 条 件 下 ， 可 传递 String[] 数 组 ， 即 使 期 望 使 
Object[] 类 型 的 数组 ， 如 下 所 示 : 
public class Computer ( 
public Computer() ( 


String[] stringArray = new String[]("a", "b", "c"}; 
printArray(stringArray); // Pass instance of String[] 




















) 


void printArray(Object[] array) { 
// Define parameter of type Object[] 
System.out.print (array); 


) 
在 Java 的 早期 版 本 中 ， 该 操作 行为 十 分 重要 ， 其 原因 在 于 : 可 使 用 不 同 的 数组 类 型 作为 参 
数 ， 如 下 所 示 : 


// Java 

static void print(Object[] array) { 
for (int i = 0; i <= array.length - 1; i++) 
System.out.print(array[i] * " "); 
System.out.println(); 

) 


// Usage 

String[] fruits = new String[] ("Pineapple","Apple", "Orange", 
"Banana"}; 

print (fruits); // Prints: Pineapple Apple Orange Banana 

Arrays.sort (fruits) ; 

print(fruits); // Prints: Apple Banana Orange Pineapple 


但 该 操作 行为 可 导致 潜在 的 运行 期 错误 ， 如 下 所 示 : 


public class Computer { 

public Computer() { 
Number[] numberArray = new Number[]{1, 2, 3); 
updateArray (numberArray); 

} 

void updateArray(Object[] array) { 
array[0] = "abc"; 
// Error, java.lang.ArrayStoreException: java.lang.String 
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) 
} 


JE, ph Ae updateArray 接收 Object[] 类 型 的 参数 ， 且 传递 String[]。 同 时 ， 利 用 String 
参数 调用 add 方法 。 由 于 数组 项 为 Object 类 型 ， 因 而 此 处 可 使 用 String， 这 也 表示 为 一 
个 新 值 。 最 后 ,还 须 添 加 String 至 仅 包 含 String 类 型 数据 项 的 泛 型 数组 中 。 考虑 到 默认 
的 协 变 行为 ， 编 译 器 无 法 检测 到 这 一 问题 ， 因 而 会 抛 出 ArrayStoreException 异常 。 

F Kotlin 编译 器 将 此 操作 行为 视 为 潜在 危险 ,因而 对 应 代码 无 法 在 Kotlin 中 被 编译 。 
这 也 体现 了 Kotlin 中 数组 为 不 可 变 的 原因 。 因 此 ， 当 需要 使 用 到 Array<Any> 且 传递 非 
Aray<Number> 时 ， 将 出 现 编译 期 错误 ， 如 下 所 示 : 


public class Array<T> ( /*...*/ } 



























































根据 这 一 点 ， 当 需要 使 用 Array<Any> 且 传递 非 Array<Number> 类 型 时 ， 将 产生 编译 期 错 
误 ， 如 下 所 示 : 
public class Array<T> ( /*...*/ } 
class Computer ( 
init ( 
val numberArray - arrayOf«Number»(1, 2, 3) 
updateArray (numberArray) 





) 
internal fun updateArray(array: Array<Any>) { 
array[0] = "abc" 


// error, java.lang.ArrayStoreException: java.lang.String 
} 
) 


注意 ， 潜 在 的 运行 期 异常 仅 发 生 于 调整 对 象 时 。 相 应 地 ， 变 型 也 应 用 于 Kotlin 集合 接 
中 。 在 Kotlin 标准 库 中 ， 涵 盖 了 采用 两 种 不 同方 式 定义 的 列表 接口 。 其 中 ， 鉴 于 不 可 变 
特征 ，Kotlin List 接口 具有 协 变 特性 〈 不 包含 任何 可 调整 内 部 状态 的 方法 )， 而 Kotlin 
MutableList 则 有 所 不 同 。 下 列 代码 显示 了 类 型 参数 定义 ， 如 下 所 示 : 

interface List<out E» : Collection«E» { /*...*/ } 

public interface MutableList<E> : List<E>, MutableCollection<E> ( 
VERSA etis 

} 


下 面 考 察 此 类 定义 的 实际 操作 结果 ， 进 而 定义 可 变 列 表 ， 以 减少 协 变 所 带 来 的 风险 ， 
如 下 所 示 : 


fun addElement (mutableList: MutableList<Any>) { 
mutableList.add ("Cat") 
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} 


// Usage 

val mutableIntList = mutableListOf(1, 2, 3, 4) 

val mutableAnyList = mutableListOf«Any»(1, 'A') 
addElement (mutableIntList) // Error: Type mismatch 
addElement (mutableAnyList) 


于 并 不 包含 改变 内 部 状态 的 方法 ， 因 而 该 列表 处 于 安全 状态 ， 其 协 变 行为 可 支持 更 为 丰 

















富 的 通用 函数 操作 ， 如 下 所 示 : 


fun printElements(list: List<Any>) { 
for(e in list) print (e) 
} 


// Usage 

val intList Tistori, 2» 3. 4) 

val anyList listof«Any»(1, 'A') 
printElements (intList) // Prints: 1234 
printElements (anyList) // Prints: 1A 


此 处 ， 可 向 printElements 函数 传递 List<Any> 或 其 子 类 型 一 一 List 接口 具有 协 变 特征 。 另 
外 ， 由 于 MutableList 接口 的 不 可 变性 ， 仅 可 向 addElement 传递 MutableList<Any>。 














当 采 用 in 和 out 修饰 符 时 ， 可 对 变型 行为 予以 操控 。 另 外 ， 还 应 注意 变型 包含 了 某 些 





限制 条 件 ， 下 面 对 此 加 以 讨论 。 











6.3.4 变型 的 生产 者 /消费 者 限制 条 件 
通过 变型 修饰 符 ， 可 针对 类 /接口 (声明 位 置 变型 ) 或 类 型 参数 (使 用 位 置 变型 ) 的 特 

















定 类 型 参数 获取 协 变 / 逆 变 特性 。 尽 管 如 此 ， 仍 需要 注意 某 些 限制 条 件 。 为 了 确保 安全 性 ， 


Kotlin 编译 器 限制 了 类 型 参数 的 使 用 位 置 。 





对 于 不 可 变 特性 〈 默 认 状 态 下 在 类 型 参数 中 不 包含 变型 修饰 符 )， 可 在 in〈 函 数 参数 





类 型 ) 和 out〈 函 数 返 回 类 型 ) 位 置 处 使 用 类 型 参数 ， 如 下 所 示 : 





interface Stack<T> { 
fun push(t:T) // Generic type at in position 
fun pop():T // Generic type at out position 
fun swap(t:T):T // Generic type at in and out positions 
val last: T // Generic type at out position 
var special: T // Generic type at out position 
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当 采 用 变型 修饰 符 时 ， 则 仅 限 定 于 某 个 单一 位 置 。 这 也 表明 ， 针 对 方法 参数 Gn) 或 
者 方法 返回 值 (out)， 仅 可 将 类 型 参数 用 作 某 一 类 型 。 当 前 类 可 以 定义 为 生产 者 或 消费 者 ， 














因而 可 以 解释 为 ， 类 接收 参数 或 生成 参数 。 

















F 


考察 该 限定 条 件 与 变型 修饰 符 之 间 的 关系 如 何在 声明 点 处 加 以 定义 。 针 对 两 种 类 








型 参数 R 和 T， 下 列 代码 展示 了 其 正确 和 错误 的 应 用 方式 。 


class ConsumerProducer<in T, out R> ( 


) 


fun consumeItemT(t: T): Unit ( ) // 1 


fun consumeItemR(r: R): Unit ( ) // 2, error 
fun produceItemT(): T ( // 3, error 
// Return instance of type T 
E 
fun produceItemR(): R ( // 4 
// Return instance of type R 
) 


针对 注释 1: 正确 ， 类 型 参数 TT 位 于 in 位 置 处 ， 对 于 注释 2: 错误 ， 类 型 参数 R 位 于 in 


位 置 处 ; 








对 于 注释 3: 错误 ， 类 型 参数 T 位 于 out 位 置 处 ， 对 于 注释 4: 正确， 类 型 参数 民 


位 于 out 位 置 处 。 


不 难 发 现 ， 若 当前 配置 被 禁用 ， 编 译 器 将 报告 一 条 错误 信息 。 注 意 ， 可 针对 两 种 类 型 
参数 R 和 了 T 添 加 不 同 的 修饰 符 。 

位 置 限定 条 件 仅 适用 于 类 外 部 可 访问 (可 见 ) 的 方法 ， 这 也 表明 ， 对 应 方法 不 仅 包括 
之 前 所 用 的 全 部 public 方法 (public 定义 为 默认 的 标识 符 ), 而 且 还 涵盖 了 标记 为 protected 
或 internal 的 方法 。 若 将 方法 的 可 见 性 修改 为 private， 则 可 在 任意 位 置 使 用 类 型 参数 R 
和 T)， 类 似 于 不 可 变 的 类 型 参数 ， 如 下 所 示 : 


class ConsumerProducer<in T，out R> { 


$ 


private fun consumeItemT(t: T): Unit ( ) 
private fun consumeItemR(r: R): Unit ( ) 
private fun produceItemT(): T ( 

// Return instance of type T 
} 
private fun produceItemR(): R { 

//Return instance of type R 
} 





对 于 用 作 类 型 的 类 型 参数 ， 表 6.1 显示 了 全 部 所 允许 的 位 置 。 
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可 见 性 修饰 符 不 可 变性 逆 变 性 Gin) 


public, protected, internal in/out in 


6.3.5 “不 可 变 构造 函数 


对 于 之 前 描述 的 in 和 out 位 置 规则 ， 存 在 一 个 较为 重要 的 例外 情形 : 构造 函数 参数 通 
常 处 于 不 可 变 状态 ， 如 下 所 示 : 


class Producer<out T»(t: T) 

// Usage 

val stringProducer - Producer ("A") 

val anyProducer: Producer<Any> = stringProducer 


其 中 ,构造 函 数 表示 为 公有 类 型 ， 类 型 参数 了 则 声明 为 out， 但 在 in 位 置 处 ， 仍 可 将 其 用 
作 构 造 函数 参数 类 型 。 其 原因 在 于 ， 构 造 函 数 方法 无 法 在 实例 创建 后 被 调用 ， 因 而 一 直 处 
于 安全 调用 状态 。 

第 4 章 曾 讨论 到 ， 可 通过 val 或 var 修饰 符 直 接 在 类 构造 函数 中 定义 属性 。 当 指定 协 
变 特 性 时 ， 可 在 包含 协 变 类 型 的 构造 函数 中 仅 定义 只 读 〈val) 属性， 因而 处 于 安全 状态 ， 
其 原因 在 于 : 仅 生 成 get 方法 ， 因 而 该 属性 值 无 法 在 类 实例 化 后 被 修改 ， 如 下 所 示 : 

class Producer<out T>(val t: T) // Ok, safe 

当 使 用 var 时 ，get 和 set 方法 均 由 编译 器 生成 ， 因 此 ， 属 性 值 可 在 某 点 处 产生 变化 。 
这 也 解释 了 为 何 无 法 在 构造 函数 中 声明 一 个 协 变 类 型 的 只 写 (var) 属性 ， 如 下 所 示 : 

class Producer<out T>(var t: T) // Error, not safe 

如 前 所 述 ， 变 型 限定 条 件 仅 适用 于 外 部 客户 端 ， 因 而 仍 可 定义 一 个 只 写 属性 ， 即 添加 
一 个 私有 可 见 性 标识 符 ， 如 下 所 示 : 


class Producer<out T»(private var t:T) 


一 个 较为 常见 的 泛 型 限制 条 件 则 与 类 型 擦 除 有 关 〔 源 自 Tava)» 
64 Jk 9H RBR 


JVM 中 引入 了 类 型 擦 除 ， 以 使 JVM 字 节 码 向 后 兼容 于 泛 型 出 现 之 前 的 某 些 版 本 。 在 
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Android 平台 上 ，Kotlin 和 Java 均 编译 为 JVM 字 节 码 ， 因 而 都 会 受到 类 型 擦 除 的 影响 。 
类 型 擦 除 是 指 从 泛 型 中 移 除 类 型 参数 这 一 处 理 过 程 ， 因 而 泛 型 在 运行 期 时 将 丢失 某 些 
类 型 信息 类 型 参数 )， 如 下 所 示 : 


package test 
class Box<T> 








val intBox = Box<Int>() 
val stringBox = Box<String>() 


println(intBox.javaClass) // prints: test.Box 

println(stringBox.javaClass) // prints: test.Box 
编译 器 可 区 分 两 种 类 型 ， 并 可 确保 类 型 安全 性 。 然 而 ， 在 编译 时 ， 参 数 化 类 型 Box<Int> 和 
Box<String> 均 被 编译 器 转换 为 Box〈 原 始 类 型 )。 生 成 的 Java 字 节 码 并 不 包含 与 类 型 参数 
相关 的 任何 信息 ， 因 而 无 法 在 运行 期 区 分 泛 型 。 

类 型 控 除 可 能 会 导致 某 些 问题 的 出 现 。 在 JVM 中 , 无 法 声明 相同 方法 的 重 载 版 本 ( 包 
含 相同 的 JVM 签名 )， 如 下 所 示 : 

/* 

java.lang.ClassFormatError: Duplicate method name&signature... 

ol 

fun sum(ints: List<Int>) { 

println("Ints") 














) 


fun sum(strings: List«String») ( 
print1n ("Ints") 
} 


当 移 除 类 型 参数 后 ， 上 述 两 个 方法 将 包含 相同 的 声明 ， 如 下 所 示 : 


/* 
java.lang.ClassFormatError: Duplicate method name&signature... 
*y 
fun sum(ints: List) ( 
print1n ("Ints") 
} 
fun sum(strings: List) ( 
println("Ints") 
} 
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除 此 之 外 ， 还 可 通过 修改 生成 的 函数 JVM 名 来 解决 这 一 类 问题 。 对 此 ， 当 代码 编译 

















为 JVM 字 节 码 时 ， 可 使 用 JvmName 修改 某 个 方法 名 ， 如 下 所 示 : 


GJvmName("intSum") fun sum(ints: List<Int>) { 
println("Ints") 

) 

fun sum(strings: List«String») ( 
println("Ints") 

} 








在 Kotlin 中 ， 函 数 在 使 用 过 程 中 未 发 生 任何 变化 ， 但 由 于 修改 了 第 一 个 函数 的 JVM 名 ， 











因而 需要 通过 新 名 称 在 Java 中 使 用 该 函数 ， 如 下 所 示 : 





// Java 
TestKt.intSum(listOfInts) ; 


某 些 时 候 ， 可 能 需要 在 运行 期 保留 类 型 参数 ， 对 此 ， 可 使 用 reified 类 型 参数 。 
6.4.1 reified 类 型 参数 
在 某 些 场合 下 ， 在 运行 期 访问 类 型 参数 十 分 有 用 ， 但 考虑 到 类 型 擦 除 ， 该 操作 往往 被 





禁止 ， 如 下 所 示 : 


fun «T» typeCheck(s: Any) ( 
"fts: is T 
// Error: cannot check for instance of erased type: T 
println("The same types") 
) else ( 
println("Different types") 
} 
5 


为 了 克服 JVM 限制 条 件 ，Kotlin 采用 了 特定 修饰 符 ， 并 可 在 运行 期 持 有 类 型 参数 。 对 
需要 通过 reified 标识 符 标记 类 型 参数 ， 如 下 所 示 ; 


interface View 
class ProfileView: View 
class HomeView: View 
inline fun «reified T» typeCheck(s: Any) { // 1 
Afis 1s TI 
printin("The same types") 
) else ( 
println("Different types") 


* 196 * 零 基 础 学 Kotlin 编程 


) 
} 
// Usage 
typeCheck«ProfileView» (ProfileView()) // Prints: The same types 
typeCheck«HomeView» (ProfileView()) // Prints: Different types 
typeCheck«View» (ProfileView()) // Prints: The same types 


在 注释 1 中 ， 显 示 了 标记 为 reified 的 类 型 参数 ， 以 及 标记 为 inline 的 函数 。 

当前 ， 可 在 运行 期 内 安全 地 访问 类 型 参数 。 其 中 ，reified 类 型 参数 仅 与 内 联 函数 协同 
工作 一 一 在 编译 (内 联 》 期 间 ，Kotlin 编译 器 将 替换 reified 类 型 参数 的 实际 类 。 通 过 这 一 
方式 ， 类 型 参数 不 会 被 类 型 擦 除 所 移 除 。 

另外 ， 还 可 在 reified 类 型 上 使 用 反射 机 制 ， 进 而 获得 与 当前 类 型 相关 的 更 多 信息 ， 如 
下 所 示 : 

inline fun «reified T» isOpen(): Boolean { 

return T::class.isOpen 











} 

reified 类 型 参数 在 IVM 字 节 码 级 别 中 有 所 体现 , 并 针对 基础 类 型 作为 一 种 真实 类 型 或 
封装 器 类 型 ， 因 而 reified 类 型 参数 不 会 受到 类 型 擦 除 的 影响 。 

reified 类 型 参数 可 通过 一 种 全 新 的 方法 编写 代码 。 当 在 Java 中 启动 一 个 新 的 Activity 
时 ， 可 编写 如 下 代码 : 


// Java 
startActivity (Intent (this, ProductActivity::class.java)) 


在 Kotlin 中 ， 可 定义 startActivity 方法 ， 并 通过 相对 简单 的 方式 导航 至 Activity， 如 下 
所 示 : 


inline fun «reified T : Activity» startActivity(context: Context) ( 
context.startActivity(Intent(context, T::class.java)) 








) 


// Usage 
startActivity<UserDetailsActivity> (context) 


之 前 定义 了 startActivity 方法 ， 通 过 类 型 参数 ， 可 传递 与 Activity (ProductActivity) 相关 
的 信息 。 另 外 ， 还 须 定义 一 个 显 式 的 reified 类 型 参数 约束 ， 以 确保 仅 可 使 用 Activity (及 
其 子 类 ) 作为 类 型 参数 。 


6.4.2 startActivity 方法 











为 了 正确 使 用 startActivity 方法 , 需要 一 种 方式 将 参数 传递 至 启动 的 Activity (Bundle) 








第 6 章 Z 型 。197 。 








中 。 相 应 地 ， 可 能 需要 更 新 之 前 的 实现 ， 以 支持 下 列 参数 : 
startActivity<ProductActivity>("id" to 123, "extended" to true) 

在 上 述 示例 中 ， 参 数 通过 所 提供 的 键 值 对 被 过 滤 〈 定 义 于 to 内 联 函 数 中 )。 该 函数 的 具体 

实现 则 超出 了 本 书 的 讨论 范围 。 尽 管 如 此 ， 仍 可 使 用 现 有 的 函数 。 其 中 ，Anko 库 ( 位 于 

https:/ /github. com/ Kotlin/anko) 已 实现 了 startActivity 方法 ， 并 包含 了 全 部 所 需 功能 。 此 

处 仅 须 导 入 Appcompat-v7-commons 即 可 ， 如 下 所 示 : 


compile "org.jetbrains.anko:anko-appcompat-v7-commons:$anko version" 


Anko 针对 Context 和 Fragment 类 定义 了 扩展 ， 因 而 可 像 类 中 的 其 他 方法 那样 ， 使 用 
Activity 或 Fragment 中 的 当前 方法 ， 且 无 须 再 在 前 类 中 定义 方法 。 关 于 扩展 ， 第 7 章 将 对 
此 加 以 讨论 。 

需要 注意 的 是 ，reified 类 型 参数 包含 了 一 个 主要 的 限制 条 件 : 无 法 从 reified 类 型 参数 
中 创建 类 实例 不 使 用 反射 机 制 )， 其 后 的 原因 可 描述 为 :构造 函数 通常 仅 与 实例 一 般 
不 采用 继承 ) 关联， 因而 不 存在 适用 于 所 有 类 型 参数 的 构造 函数 。 


6.5 星 号 投射 






























































鉴于 类 型 擦 除 ， 运 行 期 内 往往 会 出 现 不 完整 的 类 型 信息 。 例 如 ， 无 法 得 到 泛 型 类 型 参 
数 ， 如 下 所 示 : 

val list = listof(1,2,3) 

println(list.javaClass) // Prints: class java.util.Arrays$ArrayList 
这 将 会 产生 某 些 问题 。 例 如 ， 无 法 执行 任何 检测 ， 以 验证 List 包含 的 数据 元 素 类 型 ， 如 下 
所 示 : 

/* 

Compile time error: cannot check instance of erased type: 

List«String» 

m 

if(collection is List«Int») ( 


ford 
} 


由 于 检测 在 运行 期 内 执行 ， 且 与 类 型 参数 相关 的 信息 尚 不 完整 ， 因 而 会 出 现 此 类 问题 。 然 
而 ， 与 Java 中 的 操作 相反 ，Kotlin 不 允许 声明 原始 类 型 〈 未 利用 类 型 参数 实现 参数 化 的 泛 
型 )， 如 下 所 示 : 
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SimpleList<> // Java: ok 
SimpleList<> // Kotlin: error 


相反 ，Kotlin 使 用 星 号 投射 语法 ， 基 本 上 ， 与 类 型 参数 相关 的 信息 缺失 或 者 不 太 重 要 ， 如 
下 所 示 : 


if(collection is List<*>) { 
Vies 





} 

通过 星 号 投射 语法 ， 可 以 说 Box 存储 了 特定 类 型 的 参数 ， 如 下 所 示 : 
class Box<T> 

val anyBox = Box<Any>() 

val intBox = Box<Int>() 


val stringBox = Box<String>() 
var unknownBox: Box<*> 


unknownBox = anyBox // Ok 
unknownBox = intBox // Ok 
unknownBox = stringBox // Ok 


需要 注意 的 是 ， Box<*> 和 Box<Any> 之 间 稍 有 不 同 。 如 果 希 望 定义 包含 Any 数据 项 的 
列表 ， 则 可 使 用 Box<Any>， 然而， 如 果 打算 定义 包含 特定 类 型 数据 项 的 列表 ， 但 该 类 型 
未 知 ( 可 能 是 Any, Int, String 等 ， 且 并 不 包含 与 该 类 型 相关 的 信息 )， 此 时 Box<Any> 意 
味 着 当前 列表 包含 了 Any 类 型 列表 。 对 此 ， 可 使 用 Box<*>， 如 下 所 示 : 

val anyBox: Box«Any» = Box<Int> // Error: Type mismatch 

如 果菜 个 泛 型 利用 多 个 类 型 参数 加 以 定义 ， 则 需要 针对 缺失 的 类 型 参数 使 用 星 号 (*)， 
如 下 所 示 : 


class Container<T, T2> 
val container: Container<*, *> 


当 需 要 在 该 类 型 上 执行 某 项 操作 时 ， 星 号 投射 十 分 有 用 ， 而 与 类 型 参数 相关 的 信息 则 
显得 不 那么 重要 ， 如 下 所 示 


fun printSize(list: MutableList<*>) { 
println(list.size) 








) 
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// usage 

val stringList = mutableListOf("5", "a", "2", "d") 
val intList = mutableListOf(3, 7) 
printSize(stringList) // prints: 4 
printSize(intList) // prints: 2 














在 上 述 示例 中 ， 并 不 需要 使 用 到 与 类 型 参数 相关 的 信息 以 确定 集合 的 尺寸 。 如 果 不 使 
决 于 类 型 参数 的 相关 方法 ， 星 号 投射 语法 可 减少 variance 修饰 符 的 使 用 概率 。 


6.6 ”类 型 参数 命名 规则 








针对 参数 的 命名 ， 宣 方 发 布 的 Java 类 型 参数 命名 规则 (参见 https://docs.oracle. 
javase/tutorial/java/generics/types.html) 定义 了 以 下 指导 原则 ; 
默认 状态 下 ， 类 型 参数 名 称 表 示 为 大 写 的 单一 字母 ， 这 与 已 知 的 变量 命名 规则 形 


鲜明 的 对 比 。 如 果 缺 少 这 一 点 ， 将 难以 区 分 类 型 变量 和 常规 类 〈 或 接口 ) 之 间 的 差别 。 


中 ， 较 为 常见 的 类 型 参数 名 称 如 下 所 示 。 

eE: 数据 元 素 (广泛 地 用 于 Java 集合 框架 中 )。 

eK: fit. 

eN: 数字 。 

eT: 类 型 。 

eV: fü. 

eS、U、YV 等 : 表示 为 第 二 种 、 第 三 种 、 第 四 种 类 型 。 

Kotlin 标准 库 中 的 许多 类 均 支 持 这 一 规则 ， 且 针对 常见 类 均 工作 良好 ， 例 如 普通 














com/ 


成 了 




















(List, Mat, Set 等 )， 或 者 定义 了 某 个 简单 类 型 参数 的 类 (Box<T> 类 )。 然 而 ， 当 使 





定义 类 以 及 多 个 类 型 参数 时 ， 读 者 会 迅速 意识 到 ， 单 字母 无 法 包含 足够 的 信息 量 ， 某 
候 ， 将 难以 了 解 类 型 参数 表达 的 数据 类 型 。 针 对 这 一 问题 ， 存 在 多 种 处 理 方 案 。 
另外 ， 应 确保 泛 型 实现 较 好 的 文档 化 管理 。 尽 管 如 此 ， 通 过 简单 地 查看 代码 ， 有 


无 法 确定 类 型 参数 的 真实 含义 。 虽 然 文 档 十 分 重要 ， 但 仍然 是 一 类 辅助 信息 源 ， 读 者 还 


应 提升 代码 的 可 读 性 。 








lg HS 
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多 年 以 来 , 程序 员 已 倾向 于 遵循 具有 实际 意义 的 命名 规则 。Google Java 风格 指南 ( 参 


JL https://google.github.io/styleguide/javaguide.html#s5.2.8- type-variable-names) 简要 地 
了 官方 类 型 参数 命名 规则 以 及 自 定义 命名 规则 之 间 的 混合 操作 ， 并 提出 了 两 种 独特 


介绍 
的 风 


Fi. 第 一 种 风格 是 使 用 单一 的 大 写字 母 , 随后 是 可 选 的 单一 数字 (不 同 于 Java 中 描述 的 S、 


U、V 名 称 )， 如 下 所 示 : 
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class Box<T, T2» 
第 二 种 风格 则 更 具 描 述 性 ， 并 针对 类 型 参数 添加 了 富有 含义 的 前 级 ， 如 下 所 示 : 


class Box<RequestT> 


然而 ， 针 对 类 型 参数 名 称 ， 目 前 尚 不 存在 单一 标准 。 较 为 常见 的 解决 方案 是 使 用 单一 大 
写字 母 。 需 要 注意 的 是 ， 类 一 般 常 使 用 泛 型 ， 因 而 适宜 的 命名 机 制 将 改善 代码 的 可 读 性 。 
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本 章 讨论 了 泛 型 这 一 概念 ， 泛 型 类 和 接口 的 定义 方式 ， 以 及 泛 型 的 声明 方式 。 通 过 使 
点 和 声明 点 variance 修饰 符 ， 本 章 介绍 了 子 类 型 关系 的 处 理 方式 。 另 外 ， 本 章 还 解释 了 
类 型 擦 除 ， 以 及 如 何 通 过 reified 类 型 参数 在 运行 期 内 持 有 泛 型 。 

第 7 章 将 讨论 Kotlin 中 较为 重要 的 特性 之 一 ， 即 扩展 ， 该 特性 可 向 现 有 类 中 添加 新 的 
操作 行为 。 此 外 ， 还 将 探讨 如 何 针 对 任意 既定 类 实现 相应 的 新 方法 和 属性 ， 包 括 源 
Android 框架 和 第 三 方 库 的 结果 类 
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在 第 6 章 中 ,相信 大 多 数 开 发 人 员 对 其 中 所 介绍 的 概念 已 十 分 熟悉 。 本 章 主要 考察 Java 











中 未 曾 涉及 的 内 容 一 一 扩展 。 这 也 是 Kotlin 中 较为 优异 的 特性 ， 且 受到 了 大 量 Kotlin 程序 





员 的 喜爱 。 在 Android 开发 中 ， 扩 展 可 视 为 一 项 重大 的 改进 措施 。 


本 章 主 要 涉及 以 下 内 容 : 
e 扩展 函数 。 

e 扩展 属性 。 

e 成 员 扩展 函数 。 

e 泛 型 扩展 函数 。 

e 集合 处 理 。 


e 包含 接收 者 的 函数 类 型 ， 以 及 包含 接收 者 的 函数 字面 值 。 


e 面向 任意 对 象 的 Kotlin 泛 型 扩展 函数 。 
e Kotlin 域 特定 语言 。 


7T1 扩展 函数 


所 有 大 型 Java 项 目 一 般 均 会 使 用 到 工具 类 ， 例 如 StringUtils、ListUtils、AndroidUtils 
等 。 这 一 类 工具 函数 具有 普遍 模式 ， 并 采用 相对 简单 的 方式 测试 和 使 用 。 相 关 问 题 主要 体 
ME, Java 对 于 此 类 函数 的 创建 和 应 用 的 支持 度 较 差 ， 其 原因 在 于 : 此 类 函数 须 实 现 为 某 
个 类 的 静态 函数 。 下 面 通过 一 个 示例 讨论 这 一 问题 。Java Android 开发 人 员 基本 都 熟悉 下 


列 Toast 输出 代码 : 




















Toast.makeText(context, text, Toast.LENGTH SHORT).show(); 
当 显 示 错 误 或 短 消 息 时 ， 常 会 在 Android 项 目 中 对 此 加 以 使 用 ， 同 时 ， 在 大 多 数 Android 
教程 中 ， 一 般 会 在 开始 处 即 予 以 介绍 。 由 于 采用 类 似 于 构造 器 的 方式 使 用 静态 函数 ， 因 而 
实现 代码 较为 元 长 。 或 许 ，Java Android 开发 人 员 或 多 或 少 会 在 返回 对 象 上 忘记 调用 show 








方法 ， 进 而 检测 全 部 环境 条 件 以 寻找 其 中 的 原 

















因 。 对 此 ， 有 必要 将 这 一 简单 函数 封装 为 一 


个 工具 函数 。 但 实际 上 ,通常 较 少 使 用 这 一 方式 ， 为 了 理解 这 一 点 ， 考 察 Java 中 的 下 列 实 





现 方式 : 


public class AndroidUtils ( 





public static void toast(Context context, String text) { 
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Toast.makeText (context, text, Toast.LENGTH SHORT).show(); 


// Usage 

AndroidUtils.toast(context, "Some toast"); 

当 程 序 员 需 要 使 用 下 列 函 数 时 ， 需 要 回忆 是 否 存在 该 函数 、 类 的 位 置 以 及 名 称 。 因 此 ， 
其 应 用 并 未 得 到 简化 。 如 果 未 修改 Android SDK 实现 ， 一 般 不 可 能 将 其 实现 为 Context 77 
法 (Activity 的 子 类 )。 但 在 Kotlin 中 ， 则 可 以 生成 扩展 函数 ， 其 行为 类 似 于 定义 于 类 中 的 
实际 方法 。 下 列 代码 显示 了 作为 Context 扩展 的 toast 的 实现 方式 : 


fun Context.toast(text: String) ( // 1 
Toast.makeText(this, text, LENGTH LONG).show() //2 
























































J 


// Usage 

context.toast("Some toast") 
针对 注释 1, Context 并 未 出 现 于 参数 列表 中 ， 而 是 位 于 函数 名 之 前 ， 这 体现 了 扩展 类 型 的 
定义 方式 ， 对 于 注释 2， 在 函数 体内 部 ， 可 使 用 this 关键 字 ， 进 而 引用 相关 对 象 〈 扩 展 函 
数 于 其 上 被 调用 )。 

扩展 函数 和 标准 函数 之 间 的 解构 差异 在 于 , 函数 名 称 之 前 存在 一 个 接收 者 类 型 。 另外， 
函数 体内 部 也 包含 少许 可 见 性 变化 一 一 其 中 ， 可 通过 this 关键 字 访 问 接收 者 对 象 〈 在 该 对 
象 上 ， 扩 展 将 被 调用 ); 或 者 ， 也 可 直接 调用 其 函数 或 属性 。 根 据 这 一 定义 ，toast 函数 的 
行为 类 似 于 定义 于 Context 中 的 一 个 方法 ， 如 下 所 示 : 


context.toast("Some toast") 


























Alternatively: 
class MainActivity :Activity() ( 
override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
toast("Some text") 
} 
k 


相 比 于 toast 显示 代码 的 全 部 实现 ， 这 将 使 得 toast 的 使 用 更 加 方便 。 另 外 ， 还 可 获得 源 
IDE 的 提示 信息 ， 并 在 位 于 Context 内 部 (类 似 于 Activity 内 部 ) 或 Context 实例 上 时 调 上 
该 函数 ， 如 图 7.1 和 图 7.2 所 示 。 
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class MainActivity : Activity() ( 


override fun onCreate(savedInstanceState: Bundle?) { 
super .onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
t 


} Press Ctrl+Period to choose the selected (or first) suggestion and insert a dot afterwards >> 


图 7.1 


WS 


context. ti 
Press Ctrl+Period to choose the selected (or first) suggestion and insert a dot afterwards >> 


E72 


在 上 述 示 例 中 ，Context 表示 为 toast 函数 的 接收 者 类 型 ，this 实例 则 表示 为 接收 者 对 
象 的 引用 。 接 收 者 对 象 的 全 部 函数 和 属性 均 可 显 式 地 予以 访问 ， 因 而 有 下 列 定义 : 


fun Collection«Int».dropPercent (percent: Double) 
= this.drop(floor(this.size * percent) 


随后 ， 可 利用 下 列 代码 进行 替换 ; 


fun Collection«Int».dropPercent (percent: Double) 
= drop(floor(size * percent)) 


扩展 函数 的 应 用 体现 在 多 方面 。 类 似 的 扩展 函数 也 可 针对 View. List. String, E XT 





Android 框架 或 第 三 方 库 中 的 其 他 类 ,以 及 开发 人 员 的 自 定义 类 加 以 定义 。 扩 
添加 至 任意 可 访问 类 型 ， 甚 至 是 Any 对 象 。 下 列 代码 显示 了 可 在 各 个 对 象 上 
函数 : 


fun Any?.logError(error: Throwable, message: String = "error") 





展 函数 还 可 
调用 的 扩展 


t 


Log.e(this?.javaClass?.simpleName ?: "null", message, error) 


) 
下 列 代码 显示 了 调用 示例 : 


user.logError(e, "NameError") // Logs: User: NameError ... 
"String".logError(e) // String: error ... 
logError(e) // 1, MainActivity: error ... 


针对 注释 1， 在 MainActivity 中 进行 调用 。 
7.1.1 扩展 函数 底层 机 制 


Kotlin 函数 貌似 复杂 ,实际 上 ， 其 底层 机 制 十 分 简单 。 基 于 第 一 个 参数 的 接收 者 对 象 ， 


“204 。 零 基 础 学 Kotlin 编程 





顶级 扩展 函数 编译 为 静态 函数 。 下 面 再 次 考察 之 前 的 toast 函数 ， 如 下 所 示 : 














// ContextExt.kt 

fun Context.toast(text: String) ( 
Toast.makeText(this, text, LENGTH LONG).show() 

) 








在 编译 并 反 编 译 至 Java 后 ， 该 函数 如 下 所 示 : 


使 























// Java 
public class ContextExtKt { 
public static void toast(Context receiver, String text) ( 
Toast.makeText(receiver, text, Toast.LENGTH SHORT).show(); 
) 
t 


根据 第 一 个 参数 上 的 接收 者 对 象 ，Kotlin 顶级 扩展 函数 编译 为 静态 函数 ， 这 也 是 依然 


H Java 扩展 的 原因 ， 如 下 所 示 : 





// Java 
ContextExtKt.toast (context, "Some toast" 


除 此 之 外 ， 从 IVM 字 节 码 的 角度 来 看 ， 这 也 意味 着 ， 当 前 方法 并 非 真正 被 添加 。 但 


在 编译 期 , 所 有 扩展 函数 引用 均 被 编译 为 静态 函数 调用 。 当 扩展 函数 仅 表示 为 一 类 函数 时 ， 
函数 修饰 符 仍 可 应 用 于 其 上 ， 并 与 其 他 函数 的 应 用 方式 相同 。 例 如 ， 扩 展 函 数 可 标记 为 
inline， 如 下 所 示 : 





inline fun Context.isPermissionGranted (permission: String): Boolean = 
ContextCompat.checkSelfPermission (this, permission) == 
PackageManager.PERMISSION GRANTED 


类 似 于 其 他 inline 函数 ， 该 函数 调用 在 应 用 程序 编译 期 时 ， 将 被 实际 的 函数 体 蔡 换 。 在 实 
际 操作 过 程 中 ， 扩 展 函 数 与 其 他 函数 的 处 理 方式 并 无 两 样 ， 例 如 ， 可 表示 为 独立 表达 式 、 
包含 默认 参数 、 通 过 命名 参数 加 以 使 用 ， 等 等 。 但 此 类 实现 缺少 应 有 的 直观 结果 ， 下 面 将 
对 此 加 以 讨论 。 














1. 不 存在 重 载 方法 
若 成 员 函 数 和 扩展 函数 具有 相同 的 名 称 和 参数 ， 则 优先 选择 成 员 函 数 ， 如 下 所 示 : 
class A ( 

fun foot) f 


printin("foo from A") 
} 
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} 


fun A.foo() { 
println("foo from Extension") 
J 


A().foo() // Prints: foo from A 
上 述 代码 可 正常 工作 。 另 外 ， 即 使 是 超 类 中 的 方法 也 将 优 于 扩展 函数 ， 如 下 所 示 : 


open class A ( 
fun foo() ( 
println("foo from A") 





) 
) 


class B: A() 


fun B.foo() { 

println("foo from Extension") 
) 
A().foo() // foo from A 


据 此 ， 扩 展 函 数 不 允 许 修改 实际 对 象 的 行为 ， 且 仅 可 添加 附加 功能 。 由 于 无 法 调整 所 
对 象 的 操作 行为 〈《 和 否则， 可 能 导致 错误 且 难 以 跟踪 )， 因 而 可 确保 安全 性 。 


2. 访问 接收 者 元 素 


根据 第 一 个 函数 上 的 接收 者 对 象 ， 扩 展 函数 将 编译 为 静态 函数 ， 因 而 不 具备 额外 的 访 
IR BUR. private 和 protected 数据 元 素 均 不 可 被 访问 ， 而 包含 Java default. Java package 或 
Kotlin internal 修饰 符 的 元 素 ， 其 访问 方式 与 其 他 标准 对 象 一 致 。 
因此 ， 此 类 数据 元 素 得 到 了 应 有 的 保护 。 注 意 ， 尽 管 扩 展 函 数 功 能 强大 且 十 分 有 上 
但 仍 是 一 类 语法 糖 ， 且 并 无 太 多 新 奇 之 处 。 

3. 采用 静态 方式 处 理 扩展 

扩展 函数 仅 表示 为 包含 接收 者 〈 作 为 第 一 个 参数 ) 的 函数 ， 因 此 ， 其 调用 在 编译 期 
由 调用 函数 的 类 型 处 理 。 例 如 ， 若 针对 超 类 和 子 类 定义 了 扩展 ， 则 在 调用 期 间 选取 的 扩 
函数 则 取决 于 所 操作 的 属性 类 型 ， 如 下 所 示 : 


abstract class A 
class B: A() 
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fun A.foo() ( println("foo(A)") ) 
fun B.foo() ( println("foo(B)") } 


val b - B() 

b.foo() // prints: foo(B) 

(b as A).foo() // 1, prints: foo(A) 

val as ALD 

a.foo() // 1, prints: foo(A) 
针对 注释 1， 此 处 希望 foo(B) 为 类 型 B， 但 由 于 扩展 采用 静态 方式 加 以 处 理 ， 因 而 针对 A 
使 用 扩展 函数 一 一 变量 为 类 型 A， 关 于 编译 期 内 存在 何 种 对 象 ， 当 前 无 法 获取 相关 信息 。 
某 些 时 候 ， 当 我 们 将 扩展 函数 定义 为 最 常 被 转换 的 类 型 时 ， 不 应 该 将 扩展 函数 实现 到 
它 的 子 类 。 

这 是 一 个 较为 重要 的 限定 条 件 ， 读 者 应 对 此 牢记 ， 尤 其 是 在 公有 库 实 现 中 。 否 则 ， 某 
些 扩展 函数 将 阻碍 其 他 函数 ， 并 产生 难以 预料 的 错误 行为 。 


7.1.2 伴生 对 象 扩 展 


如 果 某 个 类 包含 所 定义 的 伴生 对 象 ， 那 么 也 可 针对 该 伴生 对 象 定义 扩展 函数 〈 以 及 属 
性 )。 为 了 进一步 区 分 某 个 类 的 扩展 ， 以 及 伴生 对 象 的 扩展 ， 需 要 在 扩展 类 型 和 函数 名 之 
间 添 加 .Companion， 如 下 所 示 : 


















































class A ( 
companion object {} 


) 
fun A.Companion.foo() ( print(2) } 


待定 义 完毕 后 ，foo 方法 可 像 在 A 伴生 对 象 中 定义 那样 予以 使 用 ， 如 下 所 示 : 

A.foo() 

需要 注意 的 是 ， 此 处 采用 类 这 一 类 型 调用 扩展 ， 而 非 类 实例 。 如 果 针对 某 个 伴生 对 象 
可 创建 扩展 函数 ， 则 需要 在 当前 类 显 式 地 定义 一 个 伴生 对 象 ， 即 使 是 一 个 空 对 象 ， 否 则 将 
无 法 定义 扩展 函数 ， 如 图 7.3 所 示 。 


class A {} 


fun A.Companion.foo() { print(2) } 





| Unresolved reference: Companion 





图 7.3 
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7.13 通过 扩展 函数 重 载 操 作 符 


操作 符 重 载 是 Kotlin 中 的 一 个 重要 特性 , 但 需要 使 用 到 Java 库 或 非 本 地 操作 符 。 例 如 ， 
在 RxJava 中 ， 采 用 CompositeDisposable 函数 管理 订阅 (subscription)。 该 集合 使 用 add 77 
法 添加 新 的 元 素 。 下 列 代码 显示 了 添加 至 CompositeDisposable 的 订阅 示例 : 
























































val subscriptions = CompositeDisposable () 


subscriptions .add (repository 
-getAllCharacters (qualifiedSearchQuery) 
-subscribeOn (Schedulers.io()) 
-observeOn (AndroidSchedulers.mainThread()) 
.subscribe(this::charactersLoaded, view::showError)) 


对 于 向 可 变 集合 中 添加 新 元 素 ，Kotlin 的 标准 方式 则 是 使 用 plusAssign (+=) 操作 符 。 
该 方法 不 仅 应 用 范围 较 广 ， 而 且 具 备 简洁 特征 ， 同 时 还 可 忽略 括号 ， 如 下 所 示 : 


val list = mutableListof(1,2,3) 
list.add(1) 
list += 1 


对 于 当前 示例 中 的 应 用 ， 可 添加 下 列 扩展 : 


operator fun CompositeDisposable.plusAssign(disposable: Disposable) 
t 














add (disposable) 
) 





随后 ， 即 可 在 CompositeDisposable 上 使 用 plusAssign 方法 ， 如 下 所 示 ; 


subscriptions += repository 
.getAllCharacters (qualifiedSearchQuery) 
. subscribeOn (Schedulers.io()) 
-observeOn (AndroidSchedulers.mainThread()) 
.Subscribe(this::charactersLoaded, view::showError) 


7.14 项 级 函数 的 应 用 位 置 





当 发 觉 其 他 程序 员 定义 的 类 中 缺少 某 个 方法 , 较为 常见 的 做 法 是 使 用 扩展 函数 。 例 如 ， 
当 确 定 View 应 添加 show 和 hide 方法 时 ， 与 设置 可 见 字段 相 比 ， 扩 展 函 数 更 加 简单 ， 并 























可 采用 手动 方式 完成 ， 如 下 所 示 : 
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fun View.show() { visibility = View.VISIBLE } 

fun View.hide() ( visibility = View.GONE } 
此 处 无 须 记 住 加 载 util 函数 的 类 名 。 在 IDE 中 ， 仅 须 在 当前 对 象 之 后 输入 “.”， 即 可 搜索 
当前 项 目 和 库 中 的 方法 连同 其 对 象 扩展 ， 并 使 其 看 起 来 像 是 原始 对 象 成 员 。 虽 然 这 可 视 作 
扩展 函数 的 优点 ， 但 其 中 也 包含 了 某 些 危险 。 目 前 已 存在 大 量 的 、 表 示 为 扩展 函数 包 的 
Kotlin 库 。 当 使 用 多 个 扩展 函数 时 ，Android 代码 则 与 常规 代码 有 所 差异 。 当 然 ， 该 方式 
AHAI, FE ia: 

e 代码 短小 且 具 有 可 读 性 。 

e 代码 体现 了 相关 逻辑 ， 而 非 Android 样板 文件 。 

e 扩展 函 数 常 被 用 于 测试 ， 或者， 至 少 可 在 多 处 加 以 使 用 。 因 此 ， 可 方便 地 了 解 到 扩 

展 函数 是 否 处 于 正常 工作 状态 。 

e 当 使 用 扩展 函数 时 ， 出 现 差错 的 概率 也 大 大 降低 ; 否则 ,代码 调试 工作 将 十 分 耗 时 。 

关于 最 后 两 点 内 容 ， 下 面 再 次 考察 toast 函数 。 当 采用 下 列 方式 编写 代码 时 ， 一 般 很 

难 出 现 错误 。 


toast ("Some text") 


相 比 之 下 ， 下 列 方式 则 易于 产生 错误 : 


Toast.makeText (this, "Some text", Toast .LENGTH LONG) . show () 


在 项 目 中 使 用 大 量 的 扩展 应 用 ， 其 主要 问题 在 于 : 实际 上 ， 我 们 正在 制定 自己 的 API、 命 
名 和 实现 函数 、 确 定 参数 内 容 。 当 某 位 开发 人 员 加 入 到 团队 中 时 ， 他 需要 学 习 所 创建 的 全 
部 API 内容。 尽管 Android API 包含 不 少 缺 陷 ， 但 其 优势 主要 体现 在 应 用 广泛 ， 且 为 大 多 
数 Android 开发 人 员 所 知 。 

这 是 否 意味 着 我 们 需要 放弃 扩展 ? 当然 不 是 ! 扩展 是 一 项 十 分 有 用 的 特性 ， 可 帮助 我 
们 使 代码 更 加 短小 精 悍 ， 同 时 提高 代码 的 简洁 性 。 据 此 , 应 采取 更 加 智能 的 方式 使 用 扩展 ， 
其 中 包括 : 

e 避免 出 现实 现 同一 任务 的 多 个 扩展 。 

e 一 些 简短 、 简 单 的 功能 一 般 不 需要 使 用 到 扩展 。 

e 项 目 中 保持 一 种 代码 风格 。 对 此 ， 应 与 团队 进行 交流 并 制定 某 些 标准 。 

e 当 使 用 包含 扩展 的 共有 库 时 ， 应 予以 谨慎 处 理 : 不 可 修改 其 中 的 代码 ， 所 编写 的 扩 

展 应 与 其 匹配 ， 以 保持 API 的 简洁 性 。 


72 4 Æ S4 


本 节 首 先 讨论 扩展 属性 的 定义 ， 随 后 学 习 此 类 属性 的 可 用 位 置 。 如 前 所 述 ，Kotlin 的 
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属性 通过 其 访问 器 (getter 和 setter) 加 以 定义 ， 如 下 所 示 : 


class User(val name: String, val surname: String) ( 
val fullName: String 
get() = "$name $surname" 





) 


除 此 之 外 ， 还 可 定义 扩展 属性 ， 唯 一 的 限制 条 件 是 ， 该 属性 不 可 包含 幕后 字段 ， 其 原 
因 在 于 , 扩展 无 法 存储 状态 , 因而 不 存在 适宜 的 位 置 可 存储 该 字段 。 下 列 代码 针对 TextView 
定义 了 扩展 字段 。 


val TextView.trimmedText: String 
get() = text.toString().trim() 























// Usage 
textView.trimmedText 


类 似 于 扩展 函数 ， 上 述 实 现 将 作为 访问 器 函数 (基于 第 一 个 参数 上 的 接收 者 ) 被 编译 。 
下 列 代码 显示 了 Java 中 的 简化 结果 。 
public class AndroidUtilsKt { 
String getTrimmedText (TextView receiver) { 
return receiver.getText () .toString() .trim(); 
) 
) 
如 果 定 义 为 读 - 写 属性 ，setter 和 getter 都 需要 了 予以 实现 。 回 忆 一 下 ， 仅 不 需要 Java £ 
段 的 属性 允许 定义 为 扩展 属性 。 例 如 ， 图 7.4 和 图 7.5 中 的 代码 属于 “非法 ”内 容 。 
9 


val TextView.tagged = tkue 








| Extension property cannot be initialized because it has no backing field | 





图 7.4 


var TextView.tagged: String 
get() = ss 
set (value) { 
field = value 


Unresolved reference: field 





E 7.5 
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扩展 属性 可 与 扩展 函数 实现 交互 使 用 ， 且 常用 作 顶 级 工具 函数 。 当 需要 某 个 对 象 包含 
一 些 非 本 地 开发 属性 时 ， 可 使 用 扩展 属性 。 对 于 扩展 函数 和 扩展 属性 ， 其 使 用 决策 类 似 于 
使 用 函数 或 属性 〈 类 中 不 包含 幕后 字段 )。 作 为 提示 ， 当 底层 算法 满足 下 列 条 件 时， 根据 
规则 应 优先 使 用 属性 ， 而 非 函数 。 

e 算法 未 抛 出 错误 。 

。 算法 复杂 度 为 0(1)。 

e 算法 计算 量 较 小 (或 者 在 第 一 轮 中 被 缓存 )。 

e 多 次 调用 返回 相同 的 结果 。 

下 面 考察 一 个 简单 的 问题 。 一 般 情况 下 , 开发 人 员 需 要 使 用 到 Android 中 的 某 些 服务 ， 
但 所 用 代码 可 能 比较 复杂 ， 如 下 所 示 : 

PreferenceManager.getDefaultSharedPreferences (this) 

getSystemService(Context.LAYOUT INFLATER SERVICE) as LayoutInflater 

getSystemService(Context.ALARM SERVICE) as AlarmManager 
当 使 用 AlarmManager 2X LayoutInflater 这 一 类 服务 时 ， 程 序 员 须 了 解 以 下 内 容 : 

e 提供 服务 的 函数 名 (例如 getSystemService), 以 及 包含 该 函数 的 类 名 (例如 Context). 

e 指定 该 服务 的 字段 名 (例如 Context.ALARM_SERVICE)。 

e 当前 服务 应 转换 的 类 名 (例如 AlarmManager)。 

上 述 过 程 较为 复杂 ， 因 而 可 通过 扩展 属性 对 应 用 进行 优化 。 对 此 ， 可 采用 下 列 方式 定 
义 扩展 属性 : 

val Context.preferences: SharedPreferences 


get() = PreferenceManager 
.getDefaultSharedPreferences (this) 























































































































val Context.inflater: LayoutInflater 
get() = getSystemService(Context.LAYOUT INFLATER SERVICE) 
as LayoutInflater 


val Context.alarmManager: AlarmManager 
get() = getSystemService (Context.ALARM SERVICE) 
as AlarmManager 


自 此 ， 可 作为 Context 属性 使 用 preferences. inflater 和 alarmManager, All F rz: 





context.preferences.contains ("Some Key") 

context.inflater.inflate(R.layout.activity main, root) 

context.alarmManager.setRepeating(ELAPSED REALTIME, triggerAt, 
interval, pendingIntent) 
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上 述 示例 展示 了 只 读 扩 展 函数 的 应 用 ， 下 面 重 点 讨论 inflater 扩展 属性 ， 该 属性 可 帮助 获 
取 常 用 但 在 缺少 扩展 时 难以 获取 的 元 素 。 其 有 效 性 体现 在 ， 程 序 员 仅 须 记 住 : 所 需 内 容 仅 
为 一 个 inflater， 且 需要 Context 对 其 加 以 确定 。 同 时 ， 程 序 员 无 须 记 忆 提 供 系 统 服务 的 方 
法 名 〈getSystemService ) 及 其 所 处 位 置 〈Context)， 以 及 该 服务 应 转换 的 类 型 (Alarm 
Manager)。 换 而 言 之 ， 这 一 扩展 节省 了 大 量 的 工作 时 间 以 及 内 存 空 间 。 另 外 ， 属 性 getter 
的 执行 时 间 较 短 ， 其 复杂 度 为 O(1)， 且 不 会 抛 出 任何 错误 ， 同 时 还 将 返回 相同 的 inflater 
(实际 上 是 不 同 的 实例 ， 但 从 程序 员 角 度 来 看 ， 其 应 用 通常 保持 一 致 ， 这 一 点 十 分 重要 )。 

前 述 内 容 讨论 了 只 读 扩展 属性 ， 但 尚未 考察 只 写 扩展 属性 。 在 下 面 的 示例 中 ， 此 类 属 
性 可 替代 之 前 的 hide 和 show 方法 。 

var View.visible: Boolean 

get() = visibility == View.VISIBLE 

set(value) ( 

visibility = if (value) View.VISIBLE else View.GONE 



























































) 
通过 下 列 属性 ， 可 修改 视图 元 素 的 可 见 性 : 


button.visible 
button.visible 


除 此 之 外 ， 还 可 进一步 检测 视图 元 素 的 可 见 性 ， 如 下 所 示 : 

if(button.visible) { /* ... */ } 
当 定义 完毕 后 ， 可 将 其 视 作 一 个 View 属性 。 另 外 重要 的 一 点 是 ， 所 设置 的 内 容 与 获取 的 
内 容 保持 一 致 。 因 此 ， 假 设 不 存在 修改 元 素 可 见 性 的 其 他 线程 ， 则 可 设置 某 些 属 性 值 ， 如 
下 所 示 : 

view.visible = true 
随后 ，getter 将 提供 相同 值 ， 如 下 所 示 : 

println(view.visible) // Prints: true 
最 后 ，getter 和 setter 中 不 存在 其 他 逻辑 一 一 仅 涉及 特定 属性 中 的 变化 内 容 ， 因 而 也 可 满足 
之 前 描述 的 其 他 各 项 规则 。 


true // the same as show() 
false // the same as hide() 








7.3 RAD IR SCR tE 


前 述 内 容 讨论 了 项 级 Ctop-leveD 函数 和 属性 ， 但 也 可 在 某 个 类 或 对 象 中 对 其 加 以 定 
义 ， 其 中 定义 的 扩展 称 作成 员 扩展 ， 与 顶级 扩展 相 比 ， 常 用 于 不 同类 型 的 问题 。 
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下 面 查 看 最 为 简单 的 示例 , 其 中 使 用 了 成 员 扩 展 。 假 设 需要 删除 String 列表 中 各 个 “第 
3 个 ”元 素 ， 下 列 扩展 函数 支持 每 个 “第 i 个 ”元 素 的 删除 操作 : 








fun List«String».dropOneEvery(i: Int) = 





filterIndexed { index, _ -> index $ i == (i - 1) } 


该 函数 的 问题 在 于 ， 不 应 作为 一 个 工具 扩展 被 析 取 ， 其 原因 在 于 : 

e 不 适用 于 不 同 的 列表 类 型 (例如 User 或 Int 列表 )。 

e 应 用 范围 狭窄 ， 且 不 会 用 于 当前 项 目 中 的 其 他 处 。 
这 也 是 将 其 定义 为 private 的 原因 。 较 好 的 方法 是 作为 成 员 扩展 函数 , 将 其 置 于 当前 所 用 类 
的 内 部 ， 如 下 所 示 : 


class UsersItemAdapter : ItemAdapter() { 
lateinit var usersNames: List«String» 



























































fun processList() ( 
usersNames = getUsersList() 


) 


.map ( it.name ] 
-dropOneEvery (3) 


fun List«String».dropOneEvery(i: Int) = 


filterIndexed ( index, -> index $ i == (i- 1) } 


INP soc 


) 





这 也 可 视 作 使 





成 员 扩展 函数 的 第 一 个 原因 ， 并 以 此 保护 函数 的 可 访问 性 。 其 中 ， 可 在 同 





一 文件 中 的 最 - 





上 方 顶级 位 置 处 定义 一 个 函数 ,并 使 用 private 修饰 符 。 但 成 员 扩展 函数 的 行 


为 与 顶级 函数 有 所 不 同 。 在 前 述 代码 中 ， 此 类 函数 使 用 了 public 修饰 符 ， 且 仅 可 在 List 
<String> 上 以 及 UsersItemAdapter 中 被 调用 .因此 , 函数 仅 可 在 UsersItemAdapter 及 其 子 类 ， 
或 者 UsersItemAdapter 的 扩展 函数 中 加 以 使 用 ， 如 下 所 示 : 
fun UsersItemAdapter.updateUserList(newUsers: List<User>) { 
usersNames = newUsers 
.map { it.name } 
-dropOneEvery (3) 


} 


需要 注意 的 是 ， 当 使 用 成 员 扩展 函数 时 ， 需 要 使 用 到 实现 该 函数 的 对 象 ， 以 及 该 扩展 
函数 被 调用 的 对 象 ， 其 原因 在 于 ， 可 使 用 两 个 对 象 中 的 元 素 。 这 可 视 作 与 成 员 扩展 相关 的 












































重要 信息 : 可 以 使 用 源 自 接收 者 类 型 和 成 员 类 型 〈 不 包含 限定 符 ) 的 元 素 。 下 面 考察 其 应 



































方式 ， 该 示例 使 用 了 私有 属性 category， 如 下 所 示 : 





第 7 章 扩展 函数 和 属性 “213 


class UsersItemAdapter ( 
private val category: Category 
) : ItemAdapter() ( 


lateinit var usersNames: List«String» 


fun processList() ( 
usersNames = getUsersList() 
- fromSameCategory () 
-map ( it.name } 
} 


fun List<User>.fromSameCategory() = 
filter { u -» u.category.id == category.id } 


private fun getUsersList() = emptyList<User>() 
) 


在 成 员 扩展 函数 fromSameCategory 中 ， 代 码 在 扩展 接收 器 (List<User>) 进行 操作 ， 但 同 

时 也 使 用 了 源 自 UsersItemAdapter 的 category 属性 。 不 难 发 现 ， 通 过 这 一 方式 定义 的 函数 

需要 使 用 到 一 个 方法 ， 并 可 采用 与 其 他 方法 类 似 的 方式 加 以 使 用 。 标 准 方法 所 蕴含 的 优势 

在 于 ， 可 在 List 上 调用 ， 因 而 提供 简洁 的 流 式 处 理 ， 而 非 非 扩展 方法 应 用 ， 如 下 所 示 : 
// fromSameCategory defined as standard method 


usersNames = fromSameCategory (newUsers) 
-dropLast (3) 





// fromSameCategory defined as member extension function 
usersNames = newUsers 

. fromSameCategory () 

-dropLast (3) 


另 一 种 较为 常见 的 应 用 是 ， 成 员 扩展 函数 或 属性 可 像 常规 方法 那样 加 以 使 用 ， 但 需要 
基于 以 下 事实 : 在 成 员 函 数 内 部 ， 可 使 用 接收 者 属性 和 方法 ， 且 无 须 对 其 加 以 命名 。 当 采 
这 一 方式 时 ， 可 包含 较 少 的 语法 ， 另外， 还 可 在 接收 者 上 对 其 加 以 调用 ， 而 不 是 使 用 与 
参数 相同 的 类 型 对 其 进行 调用 。 作 为 示例 ， 对 应 方法 如 下 所 示 : 

private fun setUpRecyclerView(recyclerView: RecyclerView) ( 

recyclerView.layoutManager 
= LinearLayoutManager (recyclerView.context) 


recyclerView.adapter 
= MessagesAdapter (mutableListOf () ) 
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随后 


当 使 


} 


// Usage 
setUpRecyclerView (recyclerView) 


， 可 利用 下 列 成 员 扩 展 函 数 对 其 蔡 换 : 


private fun RecyclerView.setUp() ( 
layoutManager = LinearLayoutManager (context) 
adapter = MessagesAdapter (mutableListOf () ) 





) 


// Usage 
recyclerView.setUp() 


成 员 扩展 函数 时 ， 可 实现 简单 的 调用 以 及 函数 体 。 该 方案 的 最 大 问题 在 于 ， 无 法 清 

















晰 地 描述 所 采用 的 哪 一 个 函数 为 RecyclerView 的 成 员 ， 哪 一 个 函数 表示 为 Activity 和 
RecyclerView 扩展 的 成 员 。 稍 后 将 对 其 加 以 分 析 。 


访问 











7.3.1 接收 者 类 型 


当 定 义 了 成 员 扩展 函数 后 ， 管 理 调用 元 素 将 变 得 更 加 复杂 。 在 成 员 函 数 内 ， 可 隐 式 地 
下 列 内 容 : 

e 源 自 该 类 和 属性 的 成 员 函 数 和 属性 。 

o 源 自 接收 者 类 型 及 其 超 类 的 接收 者 类 型 函数 和 属性 。 

e 顶级 函数 和 属性 。 

因此 ， 在 setUp 扩展 函数 内 部 ， 可 使 用 成 员 和 接收 者 方法 和 属性 ， 如 下 所 示 : 


class MainActivity: Activity() { 








override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.main activity) 
val buttonView = findViewById(R.id.button view) as Button 
buttonView.setUp() 

} 


private fun Button.setUp() { 
setText ("Click me!") /7 1, 2 
setOnClickListener { showText("Hello") ) // 2 
} 
private fun showText (text: String) { 
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toast(text) 
} 
} 
针对 注释 1, setText 表示 为 Button 类 方法 ; 对 于 注释 2, 可 交替 使 用 Button 类 和 MainActivity 











这 其 中 涉及 某 些 技巧 一 一 可 能 大 多 数 人 并 不 会 意识 到 是 否 会 存在 错误 ; 另外 ，setText 
调用 可 能 会 被 showText 调用 所 交换 。 
虽然 可 在 不 同 的 接收 者 以 及 成 员 扩展 元 素 内 部 加 以 使 用 ， 为 了 对 此 予以 区 分 ， 各 种 接 
收 者 均 已 被 命名 。 首 先 ， 使 用 此 类 关键 字 的 所 有 对 象 称 作 隐 式 接收 者 ， 表 示 为 成 员 并 可 在 
不 使 用 限定 符 的 情况 下 被 访问 ， 在 setUp 函数 内 部 ， 存 在 两 个 隐 式 接收 者 ， 如 下 所 示 。 

o 扩展 接收 者 :针对 Button 所 定义 的 扩展 的 类 实例 。 

e 分 发 接收 者 : 表示 为 类 实例 ， 扩 展 于 其 中 被 声明 (MainActivity). 

需要 注意 的 是 ， 扩 展 接收 者 和 分 发 接收 者 的 成 员 均 为 同一 体内 的 隐 式 成 员 ， 一 种 可 能 
的 情况 是 ， 使 用 了 两 个 接收 者 中 包含 相同 签名 的 成 员 。 例 如 ， 如 果 将 上 述 类 修改 为 在 
textView 中 显示 文本 ， 而 不 是 在 toast 函数 中 对 其 予以 显示 ， 同 时 将 方法 名 修改 为 setText， 
这 将 包含 具有 相同 签名 的 分 发 和 扩展 接收 者 方法 (方法 一 定义 于 Button 类 中 ,方法 二 定义 
于 MainActivity 类 中 )， 如 下 所 示 : 


class MainActivity: Activity() ( 
override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate (savedInstanceState) 
setContentView(R.layout.main activity) 
val buttonView = findViewById(R.id.button view) as Button 
buttonView.setUp() 




































































) 


private fun Button.setUp() ( 
setText ("Click me!") 
setOnClickListener ( setText("Hello") ) // 1 

} 

private fun setText (text: String) { 
textView.setText (text) 

H 

} 


针对 注释 1，setText 定义 为 分 发 接收 者 和 扩展 接收 者 中 的 方法 ， 这 里 的 问题 是 ， 应 调用 哪 
一 个 方法 ? 




















*216* 零 基 础 学 Kotlin 编程 





最 终结 果 为 : setText 函数 将 被 扩展 接收 者 调用 ; 相应 地 ， 按 钮 单 击 行为 将 改变 单 击 按 
钮 的 文本 ， 其 原因 在 于 : 扩展 接收 者 优 于 分 发 接收 者 。 尽 管 如 此 ， 在 该 情形 下 ， 仍 可 通过 
限定 语法 〈 即 包含 标记 的 this 关键 字 ， 用 以 区 分 所 引用 的 接收 者 ) 使 用 分 发 接收 者 ， 如 下 
所 示 : 

private fun Button.setUp() { 

setText ("Click me!") 


setonClickListener ( 
this@MainActivity.setText ("Hello") 











) 
) 


通过 这 种 方式 ， 可 有 效 地 解决 分 发 和 扩展 接收 者 之 间 的 区 分 问题 。 
7.3.2 成 员 扩展 函数 和 属性 的 底层 机 制 


成 员 扩 展 函 数 和 属性 采用 与 顶级 扩展 函数 和 属性 相同 的 编译 方式 ， 唯 一 的 差别 在 于 位 
于 某 个 类 中 ， 且 为 非 static 状态 。 下 列 代码 显示 了 扩展 函数 的 简单 示例 。 
class A ( 
fun boo() {} 


fun Int.foo() { 
boo () 
} 
} 


这 将 编译 为 (经 适当 简化 ): 
public final class A ( 
public final void boo() ( 


} 


public final void foo(int $receiver) ( 
this.boo(); 
} 
} 


注意 ， 虽 然 它 们 只 是 作为 第 一 个 参数 的 接收 者 的 方法 ， 但 是 我 们 可 以 用 其 他 函数 对 其 进行 
处 理 。 
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74 泛 型 扩展 函数 











当 编 写 工具 函数 时 ， 通 常 需要 使 用 到 泛 型 这 一 概念 。 其 中 ， 较 为 常见 的 例子 是 集合 扩 
， 例 如 List, Map 和 Set。 下 列 代码 显示 了 List 的 扩展 属性 。 

val «T» List<T>.lastIndex: Int 

get() = size - 1 

上 述 代码 针对 泛 型 定义 了 扩展 属性 ， 此 类 扩展 适用 于 大 多 数 不 同 场合 。 作 为 例子 ， 启 动 另 
一 个 Activity 可 视 作 一 项 重复 任务 , 此 类 任务 往往 会 在 项 目 中 多 处 加 以 实现 。 对 于 Activity 
的 启用 操作 ，Android IDE 所 提供 的 方法 并 未 简化 事物 。 下 列 代码 用 于 启动 新 的 Activity， 
称 之 为 SettingsActivity。 






































startActivity(Intent (this, SettingsActivity::class.java)) 

注意 ， 这 一 简单 且 重复 性 的 任务 涵盖 了 大 量 代码 ， 且 清晰 性 较 差 。 但 可 创建 mtent 的 扩展 
函数 ， 不 包含 参数 的 Activity 将 以 更 简单 的 方式 启动 ， 同 时 使 用 了 基于 reified 类 型 的 泛 型 
内 联 扩展 函数 ， 如 下 所 示 : 


inline fun «reified T : Any» Context.getIntent() 
7 Intent(this, T::class.java) 








inline fun «reified T : Any» Context.startActivity() 
= startActivity (getIntent«T» ()) 


随后 ， 可 通过 下 列 代码 并 以 更 加 简单 的 方式 启用 Activity. 
startActivity<SettingsActivity>() 
或 者 ， 也 可 通过 下 列 方式 创建 intent。 
val intent = getIntent<SettingsActivity>() 
据 此 ， 可 以 最 小 的 代价 制定 此 类 常见 任务 。 进 一 步 讲 ， 诸 如 Anko0 这 一 类 库 提供 了 扩展 函 
数 ， 同 时 提供 了 一 种 简单 方式 启用 包含 附加 参数 或 标识 的 Activity， 如 下 所 示 : 
startActivity«SettingsActivity» (userKey to user) 
该 库 的 内 部 实现 超出 了 本 书 的 讨论 范围 ， 但 可 通过 向 当前 项 目 添加 Anko E (参见 
https://github.com/MarcinMoskala/ActivityStarter) 依赖 关系 ， 进 而 简单 地 使 用 此 类 扩展 。 该 
示例 的 重点 在 于 ， 几 乎 所 有 的 重复 性 代码 均 可 通过 扩展 被 简单 的 代码 所 蔡 代 。 除 此 之 外 ， 
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还 存在 一 种 备 选 方案 可 启用 Activity， 例 如 ActivityStarter 库 (参见 https://github.com/Marcin 
Moskala/ActivityStarter)， 该 库 基于 参数 注入 同时 支持 Kotlin， 如 下 所 示 : 
class StudentDataActivity : BaseActivity() { 


lateinit @Arg var student: Student 
@Arg(optional = true) var lesson: Lesson 





= Lesson.default () 
) 
或 者 作为 蔡 代 方案 ， 还 支持 Kotlin 属性 托管 中 的 延迟 注入 参见 第 8 章 )， 如 下 所 示 : 
class StudentDataActivity : BaseActivity() { 
Gget:Arg val student: Student by argExtra() 


Gget:Arg(optional = true) 
var lesson: Lesson by argExtra (Lesson.default ()) 


) 
包含 此 类 参数 的 Activity 可 通过 生成 后 的 静态 参数 予以 启用 ， 如 下 所 示 : 


StudentDataActivityStarter.start(context, student, lesson) 
StudentDataActivityStarter.start(context, student) 


下 面 考察 另 一 个 示例 。 在 Android 中 ， 常 常 需要 以 JSON 格式 存储 对 象 ， 例 如 将 其 发 
送 至 API 中 ， 或 者 存储 于 某 个 文件 中 。 对 于 JSON 中 的 序列 化 和 反 序 列 化 ， 较 为 常用 的 库 
是 Gson。 下 面 讨论 Gson 库 的 标准 应 用 方式 ， 如 下 所 示 : 

val user = User("Marcin", "Moskala") 


val json: String = globalGson.toJson (user) 


val userFromJson = globalGson.fromJson(json, User::class.java) 


根据 包含 inline 修饰 符 的 扩展 函数 ， 可 在 Kotlin 中 对 此 加 以 改进 。 下 列 扩展 函数 示例 使 
了 GSON， 将 对 象 打包 / 解 包 至 ISON 格式 中 的 String, W FAR: 


inline fun Any.toJson() = globalGson.toJson(this)!! 





























inline fun «reified T : Any» String.fromJson() 
= globalGson.fromJson(this, T::class.java) 


// Usage 

val user - User("Marcin", "Moskala") 

val json: String - user.toJson() 

val userFromJson: User = json.fromJson«User»() 
其 中 ，globalGson 实例 表示 为 全 局 Gson 实例 。 这 可 视 作 一 类 常见 操作 ， 但 通常 会 定义 某 
些 序列 化 器 和 反 序 列 化 器 ， 这 可 视 作 一 种 简单 、 高 效 的 方式 ， 从 而 一 次 性 地 对 其 进行 定义 


并 构建 Gson 实例 。 














第 7 章 扩展 函数 和 属性 *219* 





一 些 示 例 向 程序 员 展 示 了 泛 型 扩展 函数 的 各 种 可 能 性 ， 它 们 更 像 是 代码 所 提取 的 下 一 





个 级 别 ， 其 中 包括 : 


e 表示 为 顶级 函数 ， 但 也 可 在 某 个 对 象 上 加 以 调用 ， 因 而 便于 管理 。 














e 表示 为 泛 型 函数 ， 因 而 应 用 范围 


较 广 。 





e 当 采 用 inline 时 ， 可 定义 reified 





类 型 参数 。 


这 也 体现 了 泛 型 扩展 函数 在 Kotlin 中 普遍 使 用 的 原因 。 另 外 ， 标 准 库 也 提供 了 大 量 的 
泛 型 扩展 函数 ， 稍 后 将 会 讨论 某 些 集合 扩展 函数 。 这 一 部 分 内 容 较为 重要 ， 不 仅 是 因为 可 


提供 与 泛 型 扩展 函数 使 用 方面 的 知识 ， 























同时 还 描述 了 Kotlin 中 列表 处 理 方式 以 及 应 用 方式 。 








集合 处 理 在 程序 设计 中 是 一 类 常见 任务 ， 开 发 人 员 往 往 会 首先 学 习 到 集合 的 遍历 方 





式 ， 进 而 对 相关 数据 元 素 进行 操作 。 侦 
如 下 所 示 : 
for (user in users) { 


println (user) 
} 


如 ， 列 表 中 的 所 有 用 户 的 输出 可 能 会 用 到 for 循环 ， 


如 果 输 出 通过 学 校 考试 的 用 户 ， 则 一 般 会 在 循环 中 加 入 下 列 站 条 件 语 句 : 


for (user in users) ( 
if ( user.passing ) ( 
println (user) 
} 
} 


这 仍 可 视 作 正确 的 实现 方式 ， 但 当 任务 变 得 复杂 时 ， 问 题 也 会 随 之 出 现 。 例 如 ， 输 出 3 名 
成 绩 最 优 的 学 生 。 在 循环 中 ， 实 现 过 程 变 得 复杂 起 来 。 对 此 ，Kotlin 中 一 种 简单 的 实现 方 

















法 是 采用 流 处 理 。 下 面 对 此 加 以 考察 ， 学 生 列 表 如 下 所 示 : 

data class Student( 
val name: String, 
val grade: Double, 
val passing: Boolean 

) 

val students = listof( 
Student("John", 4.2, true), 
Student("Bill", 3.5, true), 
Student("John", 3.2, false), 
Student("Aron", 4.3, true), 


Student("Jimmy", 3.1, true) 


) 


下 面 利用 Java 中 的 命令 式 方案 对 学 生 进 行 过滤 操 作 《〈 使 用 循环 和 排序 方法 )， 如 下 所 示 : 
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val filteredList = ArrayList<Student> () 
for (student in students) ( 

if(student.passing) filteredList += student 
} 


Collections.sort (filteredList) { pl, p2 -> 
if (pl.grade > p2.grade) -1 else 1 
} 


for Ni in 0-2) 4 
val student = filteredList[i] 
println (student) 

} 


// Prints: 

// Student (name=Aron, grade=4.3, passing=true) 
// Student (name=John, grade=4.2, passing=true) 
// Student (name=Bill, grade=3.5, passing=true) 


采用 Kotlin 流 处 理 ， 可 通过 更 加 简单 的 方式 实现 相同 结果 ， 如 下 所 示 : 


students.filter { it.passing } // 1 
.SortedByDescending ( it.grade } // 2 
.take(3) // 3 
.forEach(::println) // 4 


针对 注释 1, 获取 通过 考试 的 学 生 名 单 ; 对 于 注释 2, 根据 其 成 绩 对 学 生 排序 ; 对 于 注释 3, 
仅 取 学 生 中 的 前 3 名 ; 对 于 注释 4， 输 出 结果 。 

这 里 ， 核 心 内 容 包 括 : 各 个 流 处 理 函数 可 获取 较 小 的 功能 项 ， 例 如 sortedByDescending、 
take、forEach， 经 适当 整合 后 ， 可 发 挥 强大 的 功能 。 与 经 典 的 循环 应 用 相 比 ， 最 终结 果 更 
加 简单 且 具 有 可 读 性 。 

实际 上 ， 流 处 理 是 一 种 常见 的 语言 特性 ， 包 括 CH JavaScript, Scala 以 及 Java C AK 
本 8 后 ) 等 。 一 些 流行 的 响应 式 程序 库 也 采用 这 一 概念 处 理 数据 ， 例 如 RxJava。 下 面 将 深 
入 讨论 Kotlin 中 的 集合 处 理 。 


7.4.1 Kotin 集合 类 型 层次 结构 


Kotlin 类 型 层次 结构 实现 了 良好 的 设计 , 标准 集合 实际 上 是 源 自 本 地 语言 (例如 Java) 
中 的 集合 ， 并 隐藏 于 接口 之 后 。 其 创建 过 程 由 标准 的 顶级 函数 完成 (例如 listOf、setOf、 
mutableListOf 等 )， 因 而 可 在 公共 模块 中 创建 和 使 用 (模块 可 编译 至 多 个 平台 上 )。 男 外 ， 
Kotlin 接口 可 像 Java 中 的 对 等 接口 那样 工作 (例如 List、Set 等 )， 这 也 使 得 Kotlin 集合 更 
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加 高 效 并 兼容 于 外 部 库 。 同 时 ，Kotlin 集合 接口 层次 结构 也 可 用 于 公共 模块 中 。 对 应 的 层 
次 结构 较为 简单 ， 读 者 应 对 此 加 以 理解 ， 如 图 7.6 所 示 。 


Iterable 


Collection MutableCollection 


MutableList H 
Set 


MutableSet 







Mutablelterable 













图 7.6 


其 中 ， 较 为 通用 的 接口 是 Iterable, ARAM ERM AG ICRI I, KIT Iterable 的 任意 
对 象 均 可 用 于 for 循环 中 ， 如 下 所 示 : 


for (i in iterable) ( /* ... */ } 


多 种 不 同 的 类 型 均 实现 了 Iterable 接口 ， 包 括 全 部 集合 、 数 列 〈1...10，'a...z' 等 )， 甚 
至 是 String， 进 而 可 遍历 其 中 的 元 素 ， 如 下 所 示 : 


for (char in "Text") { print("($char)") } // Prints: (T) (e) (x) (t) 


Collection 接口 表示 为 数据 元 素 集合 ， 并 扩展 了 Iterable， 其 中 加 入 了 size 属性 ， 以 及 
contains、containsAll 和 isEmpty 方法 。 

List 和 Set 则 是 继承 自 Collection 的 两 个 主要 接口 ， 二 者 间 的 差别 在 于 ，Set 呈 无 序 状 
态 ， 且 不 包含 重复 元 素 (根据 equals 方法 )。 另 外 ，List 和 Set 接口 不 包含 修改 对 象 状 态 的 
方法 。 这 也 是 默认 状态 Kotlin 集合 视 为 不 可 变 的 原因 。 对 于 List 接口 ，Android 中 较为 
常见 的 是 ArrayList。ArrayList 是 一 类 可 变 集合 ， 但 隐藏 于 接口 List 之 后 ， 其 行为 实际 上 
处 于 不 可 变 状态 一 一 并 未 展示 任何 可 实施 变化 的 相关 方法 (除非 对 其 进行 向 下 转型 )。 

在 Java 中 , 集合 呈现 为 可 变 状态 , 但 Kotlin 接口 默认 时 仅 提 供 了 不 可 变 行为 (而 非 修 
改 集合 状态 的 方法 ， 例 如 add 和 removeAt 方 法 )， 如 下 所 示 : 

wal list = igo *b' "ew 

println(list[0]) // Prints: a 

printin(list.size) // Prints: 3 

list.add('d') // Error 

list.removeAt(0) // Error 















































全 部 不 可 变 接口 (例如 Collection, List 45) 均 包含 对 应 的 可 变 接口 〈 例 如 Mutable 
Collection, MutableList 等 )， 且 均 继 承 自 对 应 的 可 变 接口 。 这 里 ， 可 变 意味 着 可 对 实际 对 
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象 进行 调整 。 下 列 内 容 展 示 了 标准 库 中 可 变 集 合 的 接口 : 
© MutableIterable 支持 包含 变化 内 容 的 迭代 操作 。 
e MutableCollection 涵盖 了 添加 和 移 除 数据 元 素 的 方法 。 
e MutableList 和 MutableSet 对 应 于 List 和 Set 的 可 变形 式 。 
据 此 ， 可 通过 add 和 remove 方法 修改 集合 ， 进 而 修正 上 述 示例 ， 如 下 所 示 : 





val list = mutableListof('a', 


"b', 'c') 


println(list[0]) // Prints: a 
println(list.size) // Prints: 3 


list.add('d') 


print1ln (list) // Prints: 


[a, b, c, d] 


list.removeat (0) 
println(list) // Prints: [b, c, d] 





不 可 变 和 可 变 接 











如 图 7.7 所 示 。 


仅 提 供 了 少量 方法 ， 但 Kotlin 标准 库 对 此 提供 了 大 量 的 有 效 扩 

















users. 
® ù reduceRight (operation: (User, User) -> User) User 
^ reduce (operation: (User, User) -> User) User 
W = reduce ( acc, User -> ... | r User 
^ reduceRight ( User, acc -> ... 上 - User 
^ reduceRight Indexed (operation: (Int, User, User) -> User) User 
Ñ 5 reduceRightIndexed | index, User, acc -> ... } User 
^ single() User 
Ñ ò singleornull () i User? 
® ò single {... redica sex B in. User 
Ñ ùo slice (indices: IntRange) for Lis i ns List<User> 
® ò slice (indices: Iterable<Int>) for List List<User> 
® takeLast (n: Int) List<User> 
D ò take(n: Int) le<T List<User> 
® o takeLastWhile [...] 1 Li. List<User> 
D ò sortedBy {...} (cx inli i x List<User> 
© ù filter {...} t List<User> 
v indices IntRange 
入 times (other: Iterable<L>) List<Pair<User, L>> 
® ò powerset () Set<Set<User>> 
入 all [...] I Boolean 
^ any () 1 Boolean 
BB ù any {...} (predicat se Iterable Boolean 
® ù asIterable() for tterable t Iterable<User> 
D s asSequence() £ Iter Sequence<User> 
^ associate {...} Map<K, V» 
^ associateBy {...} à Map<K, User? 
Clrlé Down and CtrisUp will move caret down and up in the editor >> J em 





图 7.7 
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与 Java 相 比 ， 这 大 大 简化 了 集合 处 理 任 务 。 

Kotlin 通过 扩展 实现 了 集合 处 理 方法 ， 该 方案 包含 诸多 优点 。 例 如 ， 如 果 需 要 实现 一 
个 自 定 义 集合 〈 例 如 List)， 仅 须 实现 包含 少量 方法 的 Iterable 接口 即 可 。 同 时 ， 仍 然 可 使 
提供 于 Iterable 接口 的 全 部 扩展 。 

另 一 个 原因 是 ， 当 定义 为 接口 的 扩展 时 , 这 些 函 数 可 采取 更 加 灵活 的 方式 使 用 。 例 如， 
大 多 数 集合 处 理 函数 实际 上 表示 为 基于 Iterable 的 扩展 , 并 通过 除 Collection 之 外 的 多 种 类 
型 予以 实现 ， 例 如 Sting 或 Range。 因 此 ， 可 针对 Iterable 以 及 IntRange 使 用 所 有 扩展 函 
数 ， 对 应 示例 如 下 所 示 : 

(1..5).map ( it * 2 }.forEach(::print) // Prints: 246810 


也 极 大 地 提升 了 此 类 扩展 的 应 用 范围 。 但 下 列 事实 也 体现 了 一 定 的 缺点 ， 集 合流 处 理 方 
法 实现 为 扩展 函数 。 尽 管 扩展 可 采用 静态 方式 加 以 处 理 ， 但 针对 某 一 特定 类 型 覆 写 某 个 扩 
展 函数 则 是 错误 的 ， 其 原因 在 于 ， 若 位 于 某 个 接口 之 后 并 直接 予以 访问 时 ， 其 行为 将 有 所 
不 同 。 

下 面 对 用 于 集合 处 理 的 某 些 扩展 函数 加 以 分 析 。 


7.4.2 map, filter 和 flatMap 函数 
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前 述 内 容 曾 简要 地 介绍 了 map. filter 以 及 flatMap， 均 是 较为 基础 的 流 处 理 函 数 。 典 
H, map 函数 返回 一 个 元 素 列表 , 该 列表 数据 根据 参数 中 的 函数 进行 适当 调整 ,如 下 所 示 : 


val list = listOf(1,2,3).map ( it * 2 } 
println(list) // Prints: [2, 4, 6] 


filter 函数 仅 支持 与 所 提供 的 断言 条 件 相 匹配 的 元 素 ， 如 下 所 示 : 


val list = listof(1,2,3,4,5).map { it > 2 } 
println(list) // Prints: [3, 4, 5] 


flatMap 函数 返回 一 个 经 由 转换 函数 生成 的 、 包 含 全 部 元 素 的 单一 列表 ， 并 在 原始 集 
合 的 各 个 元 素 上 被 调用 ， 如 下 所 示 : 


val list = listOf(10, 20).flatMap { listof(it, it+1, it + 2) } 
printintiisti 7/7 Prints: lo, Mi 12r 20; Z122] 


该 函数 常用 于 实现 几何 列表 的 “扁平 化 ”， 如 下 所 示 : 


shops.flatMap { it.products } 
schools.flatMap { it.students } 


下 面 考察 此 类 扩展 函数 的 简化 实现 ， 如 下 所 示 : 
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inline fun <T, R> Iterable<T>.map (transform: (T) -> R): List<R> { //1 
val destination = ArrayList<R>() 
for (item in this) destination.add(transform(item)) // 2 
return destination 


inline fun «T» Iterable<T>.filter (predicate: (T) -> Boolean): List<T> ( // 


1b 
val destination = ArrayList<T>() 
for (item in this) if(predicate(item)) destination.add(item) // 2 
return destination 

) 


inline fun «T, R> Iterable<T>.flatMap(transform: (T) -> Collection<R>): 
List<R> ( 
dup di 
val destination = ArrayList<R>() 
for (item in this) destination.addAll(transform(item)) // 2 
return destination 
) 


针对 注释 1， 该 类 所 有 函数 均 为 mline; 针对 注释 2， 所 有 函数 均 在 循环 内 部 使 用 ， 并 返回 
包含 适当 元 素 的 新 列表 。 
大 多 数 包含 函数 类 型 的 Kotlin 标准 库 扩 展 函 数 均 为 inline, 进而 可 高 效 地 使 用 Lambda 
扩展 。 最 终 ， 全 部 集合 流 处 理 一 般 在 运行 期 编译 为 嵌 套 循环 。 下 列 示例 展示 了 简单 的 处 理 
过 程 。 
students.filter { it.passing } 


.map { "$(it.name) ${it.surname}" } 


在 编译 / 反 编 译 至 Java 后 ， 对 应 代码 如 下 所 示 : 


Collection destinationl = new ArrayList(); 
Iterator it = students.iterator(); 
while(it.hasNext()) ( 
Student student - (Student) it.next(); 
if(student.getPassing()) { 
destinationl.add (student); 




















H 

Collection destination2 = new ArrayList (destinationl.size()); 
it = destination2.iterator(); 

while(it.hasNext()) ( 
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Student student = (Student) it.next(); 
String var = student.getName() + " " + student.getSurname(); 
destination2.add (var); 

} 


7.4.8 forEach 和 onEach 函数 


前 述 章节 已 对 forEach 函数 有 所 讨论 , 并 视 作 for 循环 的 一 种 替代 方案 ,因而 可 在 各 个 
列表 元 素 上 执行 某 项 操作 ， 如 下 所 示 : 

listof("A", "B", "C").forEach ( print(it) } // prints: ABC 

A Kotlin 1.1 以 来 ， 存 在 一 个 类 似 的 函数 onEach， 也 可 在 每 个 元 素 上 调用 某 项 操作 ， 
并 返回 扩展 接收 者 〈 当 前 列表 )。 因 此 ， 可 在 流 处 理 中 在 每 个 元 素 上 调用 操作 。 日 志 功 能 
则 是 一 类 常见 示例 ， 如 下 所 示 : 

(1..10).filter { it $ 3 == 0 ] 

.onEach(::print) // Prints: 369 


maps uo 3 
-forEach(::print) // Prints: 123 





























7.4.44 withIndex 以 及 索引 变化 版 本 


某 些 时 候 ， 数 据 元 素 的 处 理 方式 取决 于 列表 上 的 索引 。 对 此 ， 一 种 处 理 该 问题 的 常见 
方法 是 使 用 withIndex 函数 ， 该 函数 返回 包含 索引 的 值 列 表 ， 如 下 所 示 : 
listof(9,8,7,6) .withIndex() // 1 
stikter T (4, ->is 252009 7/52 
.forEach ( (i, v) -> print("$v at $i,") } 
II prints: 9 aE 0 T aE 2 
针对 注释 1, withIndex 函数 将 各 个 数据 元 素 打 包 至 IndexedValue 中 ， 其 中 包含 了 当前 元 素 
及 其 索引 ; 针对 注释 2， 在 Lambda 中 ，IndexedValue 析 构 为 索引 和 数值 ， 尽 管 该 值 尚未 使 
， 但 仍 添加 了 一 个 下 划 线 并 可 予以 忽略 ， 且 这 种 代码 编写 方式 具有 较 好 的 可 读 性 。 该 行 
代码 仅 过 滤 掉 包含 偶数 索引 的 数据 元 素 。 
除 此 之 外 ， 还 存在 不 同 流 处 理 方法 的 变化 版 本 ， 并 可 提供 一 个 索引 ， 如 下 所 示 : 
Val dust) = Tistori: 2p 3, 3) 
-filterIndexed { index, => index % 2 == 0 } 
Printin(lisely WA Prints: [27731 





























val list2 = listof(10, 10, 10) 
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.mapIndexed { index, i -> index * i } 
printlIn(list2) // Prints: [0, 10, 20] 


val list3 = listof(1, 4, 9) 
.forEachIndexed { index, i -> print("$index: $i,") } 
Dn nO 


7.4.5 sum, count, min, max 和 排序 函数 


sum 函数 计算 列表 中 全 部 元 素 之 和 ， 并 可 在 List<Int>, List<Long>, List<Short>, 
List<Double>，List<Float>，List<Byte> 上 被 调用 ， 如 下 所 示 : 


val sum = listOf(1,2,3,4) .sum() 

println(sum) // Prints: 10 

通常 ， 还 需要 对 元 素 的 某 些 属性 求 和 ， 例 如 所 有 用 户 的 分 数 求 和 。 对 此 ， 可 将 用 户 列 
表 映 射 为 数值 列表 ， 并 于 随后 求 和 ， 如 下 所 示 : 


class User (val points: Int) 
val users - listOf(User(10), User(1 000), User(10 000)) 





val points = users.map ( it.points }. sum() 
println(points) // Prints: 11010 


通过 调用 map 函数 ， 无 须 生成 中 间 集 合 ， 因 而 更 加 高 效 并 可 直接 对 分 数 求 和 。 对 此 ， 
可 使 用 包含 相应 的 选择 器 的 sumBy， 如 下 所 示 : 


val points = users.sumBy ( it.points } 
println(points) // Prints: 11010 


其 中 ，sumBy 期 望 从 选择 器 中 返回 Int， 并 返回 包含 数据 元 素 求 和 结果 的 Int。 如 果 最 终结 
果 为 Double 而 非 Int， 则 可 使 用 sumByDouble 并 返回 Double, AU rz: 


class User(val points: Double) 
val users = listOf(User(10.0), User(1 000.0), User(10 000.0)) 




















val points = users.sumByDouble ( it.points } 
println(points) // Prints: 11010.0 


count 函数 也 提供 了 类 似 的 功能 ， 并 在 需要 计算 与 断言 条 件 匹 配 的 元 素 时 使 用 ， 如 下 
所 示 : 


val evens = (1..5).count { it % 2 = 1 } 
val odds = 01225) -count { it % 2 = 0 } 
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println(evens) // Prints: 3 
println(odds) // Prints: 2 
不 包含 断言 条 件 的 count 函数 则 返回 集合 或 迭代 的 尺寸 ， 如 下 所 示 : 
val nums = (1..4).count() 
println(nums) // Prints: 4 
下 一 个 较为 重要 的 函数 是 min 和 max， 并 返回 列表 中 的 最 小 和 最 大 值 。 这 一 类 函数 常 
于 包含 自然 排序 的 元 素 列表 (SCY Comparable<T> 接 口 )， 如 下 所 示 : 
val list = listOf(4, 2, 5, 1) 
println(list.min()) // Prints: 1 
println(list.max()) // Prints: 5 
println(listOf("kok", "ada", "bal", "mal").min()) // Prints: ada 
类 似 地 ， 函 数 sorted 返回 排序 列表 ， 但 需要 在 实现 了 Comparable<T> 接 口 的 元 素 集合 
上 加 以 调用 。 下 列 代码 展示 了 如 何 获取 字母 排序 的 字符 串 列 表 。 


val strs = listOf("kok", "ada", "bal", "mal").sorted() 
println(strs) // Prints: [ada, bal, kok, mal] 


若 数据 项 未 经 比较 ， 情 况 又 当 如 何 ? 此 处 ， 存 在 两 种 方法 对 其 进行 排序 。 方 法 一 根据 
比较 数据 项 排序 。 前 述 示例 根据 成 绩 对 学 生 进 行 排序 ， 如 下 所 示 ; 
students.filter ( it.passing } 
.sortedByDescending { it.grade } 
.take (3) 
-forEach(::println) 
在 该 示例 中 ,可 比较 grade 属性 对 学 生 进 行 排序 ， 其 中 使 用 了 sortedByDescending， 其 工作 
方式 类 似 于 sortedBy。 唯 一 差别 在 于 ,排序 以 降序 操作 (从 大 到 小 )。 函 数 内 的 选择 器 可 返 
回 与 自身 比较 的 任意 值 。 在 下 列 示 例 中 ， 则 通过 String 指定 顺序 。 
val list = listof(14, 31, 2) 
print (list.sortedBy { "$it" ]) // Prints: [14, 2, 31) 


类 似 的 函数 也 可 根据 选择 器 获取 最 小 和 最 大 数据 元 素 ， 如 下 所 示 : 


val minByLen = listOf("ppp", "z", "as") 
.minBy ( it.length } 
println(minByLen) // Prints: "z" 









































val maxByLen = listOf("ppp", "z", "as") 
.maxBy ( it.length } 
printin(maxByLen) // Prints: "ppp" 
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指定 排序 的 第 二 种 方式 是 定义 Comparator， 进 而 确定 元 素 的 比较 方式 。 另 外 ， 接 收 比 
较 器 的 函数 变化 版 本 则 应 包含 With 后 级 。 相 应 地 ， 比 较 器 可 通过 适配器 函数 加 以 定义 ， 
进而 将 Lambda 转换 为 SAM 类型， 如 下 所 示 : 


val comparator = Comparator<String> { el, e2 -> 
e2.length - el.length 














} 
val minByLen = listOf("ppp", "z", "as") 

- sortedWith (comparator) 
println(minByLen) // Prints: [ppp, as, z] 


Kotlin 还 引入 了 标准 库 项 级 函数 〈 例 如 compareBy 和 compareByDescending), AA Ti fii] 
化 Comparator 的 创建 过 程 。 下 列 代码 显示 了 如 何 创建 比较 器 ， 并 通过 surname 和 name 对 
学 生 进行 字母 排序 。 
data class User(val name: String, val surname: String) ( 
override fun toString() = "$name $surname" 
) 
val users = listOf( 
User("A", "A"), 
User("B", "A"), 
User("B", "B"), 
User("A", "B") 
) 


val sortedUsers - users 
.sortedWith (compareBy({ it.surname }, ( it.name })) 


print (sortedUsers) // [A A, B A, A B, B B] 
注意 ， 还 可 使 用 属性 引用 ， 而 非 Lambda 表达 式 ， 如 下 所 示 : 


val sortedUsers = users 
-SortedWith (compareBy (User::surname, User::name)) 
print(sortedUsers) // [A A, B A, A B, B B] 


groupBy 则 是 另 一 种 较为 重要 的 函数 ， 并 根据 当前 选择 器 对 数据 元 素 进 行 分 组 。 
groupBy 将 返回 Map， 并 从 所 选 的 键 映射 至 元 素 列表 ， 该 列表 经 选择 后 将 映射 至 下 列 键 : 


val grouped = listOf("ala", "alan", "mulan", "malan") 
-groupBy { it.first() } 
println(grouped) // Prints: {'a': ["ala", "alan"], "m": ["mulan", "malan"] } 
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下 面 考察 一 个 相对 复杂 的 示例 ， 即 获取 每 个 班 中 最 优 学 生 列表 。 下 列 代码 展示 了 如 何 














从 学 生 列表 中 获取 最 终结 果 。 





class Student (val name: String, val classCode: String, val meanGrade: Float) 


val students = listof( 


Student ("Homer", "1", 1.1F), 


Student ("Carl", "2", 1.5F), 


Student ("Donald", "2", 3.5F), 


Student ("Alex", "3", 4.5F), 


Student ("Marcin", "3", 5.0F), 


Student ("Max", "1", 3.2F) 
) 


val bestInClass = students 
-groupBy { it.classCode } 


.map { ( , students) -> students.maxBy ( it.meanGrade }!! } 


.map ( it.name } 


print (bestInClass) // Prints: 


7.4.6 ”其 他 流 处 理 函 数 





[Max, Donald, Marcin] 


除 此 之 外 , 还 存在 其 他 不 同 的 流 处 理 函 数 , Kotlin 在 其 网 站 中 提供 了 大 量 的 说 明文 档 。 
其 中 ， 大 多 数 扩展 函数 均 具 有 自 解释 特性 ， 开 发 人 员 可 直接 据 此 猜测 其 含义 。 在 Android 





Studio 中 ， 可 按 Ctrl # (Mac 中 则 为 Command 键 ) JAA 








Fi 目标 函数 ， 以 查看 其 对 应 实现 。 





当 在 可 变 集合 上 进行 操作 时 ， 将 会 看 到 集合 处 理 间 的 差异 ， 其 原因 在 于 : 此 处 使 用 了 
针对 可 变 类 型 (例如 Mutablelterable 和 MutableCollection) 所 定义 的 附加 扩展 。 其 中 ， 较 





为 重要 的 区 别 








在 于 ,修改 对 象 的 函数 以 命令 式 形式 构建 (例如 sort)， 而 返回 


集合 的 函数 则 常 以 动词 过 去 式 定 义 〈 例 如 sorted)。 相 关 示 例如 下 所 示 。 
e sort: 该 函数 对 可 变 对 象 进行 排序 ， 并 返回 Unit. 
e sorted: 该 函数 返回 一 个 有 序 集合 ， 并 且 不 会 改变 其 上 调用 的 集合 。 





val list = mutableListof (3,2,4,1) 


val list2 = list.sorted() 

println(list) // [3,2,4,1] 
printin(list2) // [1,2,3,4] 
list.sort() 

printin(list) // [1,2,3,4] 








包含 变化 值 新 
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7.4.7 ”集合 流 处 理 示例 


之 前 曾 讨论 了 一 些 流 处 理 函数 ， 但 对 于 复杂 示例 ， 则 会 涉及 一 些 操作 技巧 。 下 面 讨论 
某 些 较为 复杂 的 流 处 理 示 例 。 
假设 需要 根据 成 绩 获取 前 三 名 的 学 生 ， 此 处 关键 差异 在 于 ， 学 生 最 终 的 顺序 必须 和 开 
始 时 一 样 一 一 需要 注意 的 是 ， 在 以 成 绩 进 行 操作 时 ， 该 顺序 将 丢失 。 若 保留 对 应 顺序 ， 则 
须 持 有 数值 和 索引 。 其 实现 过 程 如 下 所 示 : 
data class Student( 
val name: String, 
val grade: Double, 


val passing: Boolean 


) 


























val students = listof( 
Student("John", 4.2, true), 
Student("Bill", 3.5, true), 
Student("John", 3.2, false), 
Student("Aron", 4.3, true), 
Student("Jimmy", 3.1, true) 
) 


val bestStudents = students.filter ( it.passing } // 1 
.withIndex() // 2 
.SortedBy ( it.value.grade ) // 3 
.take(3) // 4 
.SortedBy ( it.index } // 5 
.map ( it.value ) // 6 


// Print list of names 
println(bestStudents.map { it.name }) // [John, Bill, Jimmy] 
针对 注释 1， 过 滤 并 获取 通过 考试 的 学 生 ， 对 于 注释 2， 向 元 素 中 加 入 索引 ， 以 重 现 数据 
元 素 顺序 ， 对 于 注释 3， 根 据 成 绩 对 学 生 进 行 排序 ， 对 于 注释 4， 仅 获取 前 10 名 的 学 生 ; 
对 于 注释 5， 根 据 索引 排序 并 重 现 排序 ， 对 于 注释 6， 将 包含 索引 的 数值 映射 至 当前 值 。 
注意 ， 上 述 实现 较为 简洁 ， 且 集合 上 执行 的 各 项 操作 具有 良好 的 可 读 性 。 
集合 流 处 理 最 大 的 优势 在 于 ,可 方便 地 管理 该 处 理 的 复杂 度 。 如 前 所 述 ， 
大 多 数 操作 的 复杂 度 为 On), 例如 map 或 filter。 而 排序 的 复杂 度 为 
Omn*log(n))。 另 外 ， 流 处 理 操作 的 复杂 度 则 表示 为 各 个 步骤 中 的 最 大 复杂 度 ， 
因此 ,上 述 处 理 的 复杂 度 为 O(n*log(n)) 一 一 sortedBy 步骤 中 包含 了 最 大 复杂 度 。 
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假设 某 个 列表 包含 了 不 同 分 类 的 多 名 选手 ， 如 下 所 示 : 


class Result( 
val player: Player, 
val category: Category, 
val result: Double 
) 
class Player(val name: String) 
enum class Category { SWIMMING, RUNNING, CYCLING } 


对 应 的 示例 数据 如 下 所 示 : 


val results = listof( 
Result("Alex", Category.SWIMMING, 23.4), 
Result("Alex", Category.RUNNING, 43.2), 
Result("Alex", Category.CYCLING, 15.3), 
Result("Max", Category.SWIMMING, 17.3), 
Result("Max", Category.RUNNING, 33.3), 
Result("Bob", Category.SWIMMING, 29.9), 
Result("Bob", Category.CYCLING, 18.0) 





) 
下 列 代码 显示 了 如 何在 各 个 分 类 中 获取 最 优选 手 。 


val bestInCategory = results.groupBy { it.category } // 1 
.mapValues ( it.value.maxBy { it.result }?.player } // 2 

print (bestInCategory) 

// Prints: (SWIMMING-Bob, RUNNING-Alex, CYCLING=Bob} 


2034. * 


在 注释 1 中 , 将 最 终结 果 分 组 至 不 同 分 类 中 , 返回 类 型 为 <Category> 和 List<Result>; 在 注 
TE 2 中 ， 将 映射 map 函数 值 。 其 中 ， 将 得 到 当前 分 类 中 的 最 优 结 果 ， 进 而 获取 与 该 结果 所 








关联 的 选手 。mapValues 函数 的 返回 结果 为 Map<Category, Player?>。 


基于 集合 处 理 函 数 ， 上 述 示例 展示 了 如 何在 Kotlin 中 通过 简单 方式 处 理 与 集合 相关 的 
复杂 问题 。 在 与 Kotlin 工作 一 段 时 间 后 ， 相 信 程 序 员 会 对 大 多 数 函 数 有 所 了 解 ， 进 而 发 现 








集合 处 理 问题 将 变 得 十 分 简单 。 当 然 。 上 述 较为 复杂 的 函数 一 般 较为 少见 
更 为 常见 的 则 是 相对 简单 且 仅 包含 几 个 步骤 的 处 理 过 程 。 


7.4.8 序列 














; 在 日 常 编程 中 ， 


Sequence 表示 为 一 类 接口 ， 并 可 用 于 引用 数据 元 素 集合 ， 同 时 也 是 Iterable 的 蔡 代 方 
案 。 对 于 Sequence 而 言 ， 存 在 大 多 数 集合 处 理 函数 的 独立 实现 〈 例 如 ，map、filterMap、 








filter. sorted 等 )。 关 键 的 差别 在 于 这 一 类 函数 的 构造 方式 ， 即 返回 序列 ， 





并 在 前 一 序列 的 
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基础 上 打包 序列 。 据 此 ， 可 得 到 以 下 事实 : 

e 序列 尺寸 无 须 事先 知晓 。 

e 序列 处 理 将 更 加 高 效 ， 尤 其 是 对 于 大 型 集合 ， 其 中 需要 执行 多 次 转换 ( 稍 后 将 对 此 

加 以 讨论 )。 

在 Android 中 ， 序 列 常用 于 处 理 大 型 集合 ， 或 者 处 理 尺 寸 事先 未 知 的 元 素 〈 例 如 读 取 
大 型 文档 中 的 多 行 数 据 )。 序 列 的 创建 方式 多 种 多 样 ， 其 中 ， 较 为 简单 的 方法 是 在 Iterable 
上 调用 asSequence 函 数 ; 或 者 使 用 顶级 函数 sequenceOf 并 采用 类 似 于 列表 的 方式 生成 序列 。 

序列 的 大 小 无 须 事先 知晓 ， 对 应 值 仅 在 必要 时 加 以 计算 ， 如 下 所 示 : 

val = generateSequence(1) { it + 1 ) // 1. Instance of GeneratorSequence 

-map ( it * 2 ) // 2. Instance of TransformingSequence 


-take(10) // 3. Instance of TakeSequence 
.toList() // 4. Instance of List 



























































println(numbers) // Prints: [2, 4, 6, 8, 10, 12, 14, 16, 18, 20] 


针对 注释 1, generateSequence 可 视 为 一 种 序列 生成 方式 ， 该 序列 包含 了 从 1 至 无 穷 大 的 下 
一 个 数字 ; 针对 注释 2, map 函数 将 序列 打包 至 另 一 个 序列 中 ， 该 序列 从 第 一 个 序列 中 获 
取 数 值 ， 并 在 转换 后 计算 当前 值 ， 针对 注释 3， 函 数 take(10) 将 序列 打包 至 另 一 个 序列 ， 该 
序列 在 第 10 个 元 素 处 结束 。 如 果 缺 失 该 行 执行 代码 ， 处 理 时 间 将 不 确定 ， 进 而 在 某 个 不 
确定 的 序列 上 进行 操作 ; 针对 注释 4， 函 数 toList 负责 处 理 各 个 数值 ， 并 返回 至 最 终 的 列 
表 中 。 

需要 着 重 强调 的 是 ， 数 据 元 素 在 最 后 一 个 步骤 (终端 操作 ) 中 逐一 加 以 处 理 。 下 面 查 
看 另 一 个 示例 ， 其 中 ， 各 项 操作 将 针对 日 志 功 能 输出 数值 。 该 示例 始 于 下 列 代码 ; 

val seq-generateSequence(1) { println("Generated ${it+1}"); it + 1 } 

.filter { println("Processing of filter: $it"); it $ 2 == 1 ] 

.map { println("Processing map: $it"); it * 2 } 

.take (2) 
在 控制 台中 ， 输 出 结果 又 当 如 何 ? 此 时 将 不 会 输出 任何 内 容 一 一 相关 数值 并 未 被 计 
算 。 其 原因 在 于 ， 全 部 中 间 操 作 将 被 延迟 。 为 了 获取 对 应 结果 ， 须 使 用 诸如 toList 这 一 类 
终端 操作 ， 如 下 所 示 : 

seq.toList () 
随后 ， 控 制 台中 将 显示 下 列 内 容 : 


Processing of filter: 1 
Processing map: 1 
Generated 2 
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Processing of filter: 2 
Generated 3 

Processing of filter: 3 
Processing map: 3 


注意 ， 数 据 元 素 将 被 逐一 处 理 。 在 标准 的 列表 处 理 中 ， 操 作 顺 序 将 截然 不 同 ， 如 下 所 示 : 


(1..4).onEach { println("Generated $it") } 
.filter { println("Processing filter: $it"); it $ 2 = 1 } 
.map { println("Processing map: $it"); it * 2 } 


上 述 代码 将 输出 下 列 结果 : 


Generated 1 
Generated 2 
Generated 3 
Generated 4 
Processing filter: 
Processing filter: 
Processing filter: 
Processing filter: 
Processing map: 1 
Processing map: 3 


与 经 典 的 集合 处 理 相 比 ， 这 也 解释 了 序列 更 加 高 效 的 原因 一 一 无 须 在 中 间 步 又 中 生成 集 
合 。 数 值 将 采用 即时 方式 逐一 加 以 处 理 。 


7.5 包含 接收 者 的 函数 字面 值 





WN 





类 似 于 包含 函数 类 型 的 函数 ， 并 可 将 其 视 作 一 个 对 象 ， 扩 展 函 数 也 涵盖 了 其 类 型 ， 并 
可 通过 这 一 方式 予以 保存 。 这 称 作 包含 接收 者 的 函数 类 型 ， 且 类 似 于 简单 函数 类 型 ， 但 接 
收 者 类 型 位 于 参数 之 前 与 扩展 定义 类 似 )， 如 下 所 示 : 


var power: Int.(Int) -> Int 


基于 接收 者 的 函数 类 型 使 得 函数 和 类 型 具有 完整 的 衔接 性 一 一 全 部 函数 均 可 表示 为 
对 象 ， 同 时 可 通过 包含 接收 者 的 Lambda 表达 式 或 者 包含 接收 者 的 匿名 函数 加 以 定义 。 

在 包含 接收 者 定义 的 Lambda 表达 式 中 ， 唯 一 的 差别 在 于 ， 可 通过 this 引用 接收 者 ， 
并 可 显 式 地 使 用 接收 者 元 素 。 对 于 Lambda 表达 式 ， 类 型 须 在 某 个 参数 中 指定 ， 因 为 不 
存在 对 应 语法 可 确定 接收 者 类 型 。 在 下 列 代码 中 ，power 定义 为 包含 接收 者 的 Lambda 
表达 式 。 
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了 this * acc } } 


匿名 函数 也 可 定义 接收 者 ， 其 类 型 置 于 函数 名 之 前 。 在 此 类 函数 中 ， 可 在 函数 体 中 使 
this， 以 引用 扩展 接收 者 对 象 。 需 要 注意 的 是 ， 匿 名 扩展 函数 指定 了 当前 接收 者 类 型 ， 
而 可 推断 属性 类 型 。 在 下 列 代码 中 ，power 定义 为 匿名 扩展 函数 。 

power = fun tnt (no Int) = (1--ny)-fold(T)-(-acc; => this * acc } 

从 表面 上 看 ， 基 于 接收 者 的 函数 类 型 可 用 作 接 收 者 类 型 的 一 个 方法 ， 如 下 所 示 : 

val result = 10.power(3) 

printin(result) // Prints: 1000 

函数 类 型 常用 作 函 数 参 数 。 在 下 列 示例 中 ， 采 用 了 参数 函数 ， 并 在 其 创建 后 配置 某 个 
数据 元 素 ， 如 下 所 示 : 

fun ViewGroup.addTextView(configure: TextView.()->Unit) { 
val view = TextView (context) 


view.configure() 
addView (view) 





























t 
































) 


// Usage 
val linearLayout = findViewById(R.id.contentPanel) as LinearLayout 


linearLayout.addTextView ( // 1 
text = "Marcin" // 2 
textSize = 12F // 2 
) 
针对 注释 1， 此 处 采用 了 Lambda 表达 式 作为 参数 ， 针对 注释 2， 在 Lambda 表达 式 中 ， 可 
直接 调用 接收 者 方法 。 


7.5.1 Kotlin 标准 库 函 数 


Kotlin 标准 库 提 供 了 一 组 包含 泛 型 非 限定 接收 者 的 扩展 函数 〈 例 如 let. apply. also. 
with, run 和 to， 且 泛 型 不 包含 限定 条 件 )， 并 可 视 为 一 类 小 型 、 简 单 的 扩展 。 在 Kotlin 项 
目 中 ， 这 一 类 扩展 十 分 有 用 。 第 2 章 曾 简要 介绍 了 let 函数 ， 并 用 作 空 检测 的 替代 方案 ， 
如 下 所 示 : 


savedInstanceState?.let( state -> 
println(state.getBoolean ("isLocked")) 














} 
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let 的 全 部 任务 即 是 调用 特定 函数 ， 并 返回 对 应 值 。 在 前 述 示例 中 ，let 与 安全 调用 操 
作 符 结合 使 用 , 仅 当 属性 savedInstanceState 非 空 时 方 被 调用 。 这 里 ，let 函数 实际 上 仅 是 包 
含 参数 函数 的 泛 型 扩展 函数 ， 如 下 所 示 : 

inline fun «T, R» T.let(block: (T) -> R): R = block(this) 


在 stdlib 中 ， 存 在 多 个 与 let 类 似 的 函数 ， 其 中 包括 applay. also. with 和 run. 3€ T ER 
数 间 的 相似 性 ， 此 处 可 综合 对 其 进行 描述 ， 相 关 定 义 如 下 所 示 : 
inline fun «T» T.apply(block: T.() -> Unit): T ( 


block(); 
return this 



































) 
inline fun «T» T.also(block: (T) -» Unit): T ( 
block (this); 
return this 
) 
inline fun «T, R» T.run(block: T.() -> R): R = block() 
inline fun «T, R» with(receiver: T, block: T.() -> R): R = receiver.block() 


相应 地 ， 应 用 示例 如 下 所 示 : 


val mutableList = mutableListof (1) 
val mutableList = mutableListof (1) 
val letResult - mutableList.let ( 
it.add(2) 
listof("A", Lett nom 
) 
println(letResult) // Prints: [A, B, C] 
val applyResult - mutableList.apply ( 
add(3) 
listof("A", sj oka Mom 
) 
println(applyResult) // Prints: [1, 2, 3] 
val alsoResult - mutableList.also ( 
it.add(4) 
listOf("A", "B", "Cc") 
) 
println(alsoResult) // Prints: [1, 2, 3, 4] 
val runResult = mutableList.run { 
add (5) 
(3stoR("A", "HB" sem) 
3 
println(runResult) // Prints: [A, B, C] 
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val withResult = with(mutableList) ( 
add(6) 
FISCOLA”, "B^, Wey 
} 
println(withResult) // Prints: [A, B, C] 
println(mutableList) // Prints: [1, 2, 3, 4, 5, 6 


#71 显示 了 其 中 的 差别 。 





























表 71 
- 包含 接收 者 的 函数 字面 值 mm 
返回 对 参数 日 2 J 
BANAS AERAN (接收 者 对 象 表示 为 this) (接收 者 对 象 表示 为 iD 
接收 者 对 象 apply also 
函数 字面 值 的 结果 let 














这 一 类 函数 较为 相似 ， 大 多 数 时 候 可 交互 使 用 。 根 据 规则 ， 对 某 些 特殊 用 例 须 优先 使 
用 某 些 函数 。 


1. let FAK 
当 需 要 使 用 标准 函数 ， 并 在 流 处 理 中 作为 扩展 函数 时 ， 推 荐 使 用 let 函数 ， 如 下 所 示 : 


val newNumber = number.plus (2.0) 
.let ( pow(it, 2.0) } 
.times (2) 


类 似 于 其 他 扩展 ，let 函数 常 与 某 种 安全 调用 操作 符 结合 使 用 ， 如 下 所 示 : 


val newNumber = number?.plus (2.0) 
?.let ( pow(it, 2.0) } 


除 此 ， 当 仅 需 要 解 包 可 空 读 - 写 属性 时 ， 推 荐 使 用 let 函数 。 此 时 ， 无 法 对 该 属性 
进 2d 并 须 执行 下 列 屏 蔽 (shadowing) 操作 : 


var name: String? = null 























fun Context.toastName() ( 
val name — name 
if(name != null) { 
toast (name) 
) 
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其 中 ，name 变量 表示 为 屏蔽 属性 名 ， 其 必要 性 体现 在 当 名 称 为 读 写 属性 时 
仅 可 用 在 可 变 或 局 部 变量 上 。 
据 此 ， 可 利用 let 和 安全 调用 操作 符 替 换 上 述 代码 ， 如 下 所 示 : 
name?.let ( setNewName(it) } 
注意 ， 当 使 用 Elvis 操作 符 时 ， 可 简单 地 添加 return, 否则 在 name 73 null 时 将 会 抛 出 异常 ， 
下 所 示 : 
name?.let { setNewName(it) } ?: throw Error("No name setten" 
类 似 地 ，let 函数 还 可 替换 下 列 语句 : 
val comment = if(field == null) getComment (field) else "No comment 
基于 let 函数 的 实现 如 下 所 示 : 
val comment = field?.let { getComment(it) ) ?: "No comment" 
在 转换 接收 者 的 方法 链 中 ， 推 荐 使 用 基于 该 方式 的 let 函数 ， 如 下 所 示 : 


val text = "hello {name}" 





智能 转换 
































xr 





fun correctStyle(text: String) - text 
.replace("hello", "hello,") 


fun greet(name: String) ( 
text.replace("{name}", name) 
-let { correctStyle(it) } 
.capitalize() 
.let { print(it) } 
} 


// Usage 
greet ("reader") // Prints: Hello, reader 


除 此 之 外 ， 还 可 作为 参数 传递 函数 索引 ， 以 实现 更 简单 的 语法 ， 如 下 所 示 : 


text.replace("{name}", name) 
-let(::correctStyle) 
-capitalize() 
-let(::print) 


2. 针对 初始 化 操作 使 用 apply 函数 
某 些 时 候 ， 可 通过 调用 相关 方法 或 调整 一 些 属性 ， 进 而 创建 或 初始 化 对 象 。 例 如 ， 下 
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列 代码 将 生成 Button: 


val button = Button (context) 
button.text = "Click me" 
button.isVisible = true 
button.setOnClickListener ( /* ... */ } 
this.button = button 


利用 apply 扩展 函数 ， 可 减少 相应 的 元 余 代 码 。 在 button 定义 为 接收 者 对 象 的 地 方 ， 








可 根据 当前 上 下 文 调用 所 有 此 类 方法 ， 如 下 所 示 : 





button = Button(context).apply ( 
text = "Click me" 
isVisible - true 
setonClickListener ( /* ... */ } 
2; 


3. also FÁ% 
also 函数 类 似 于 apply， 其 差别 在 于 ， 参 数 函 数 作为 参数 被 接收 ， 而 非 接收 者 。 当 需要 





在 某 个 对 象 上 执行 操作 《〈 但 并 非 是 初始 化 行为 ) 时 ， 则 推荐 使 用 该 方法 ， 如 下 所 示 : 


abstract class Provider<T> { 


null 
null 


var original: T? = 
var override: T? = 


abstract fun create(): T 


fun get(): T = override ?: original ?: create().also { original = it } 
) 


当 需 要 在 处 理 过 程 中 执行 某 些 操作 时 ， 推 荐 使 用 also 函数 。 例 如 ， 在 使 用 Builder 模 





式 的 对 象 构造 过 程 中 ， 对 应 代码 如 下 所 示 : 


使 




















fun makeHttpClient (vararg interceptors: Interceptor) = 
OkHttpClient.Builder() 
-connectTimeout (60, TimeUnit.SECONDS) 
-readTimeout(60, TimeUnit.SECONDS) 
.also ( it.interceptors().addAll(interceptors) } 
-build() 


另 一 种 情况 则 是 ， 当 已 处 于 扩展 函数 中 ， 且 不 需要 添加 另 一 个 扩展 接收 者 时 ， 也 推荐 
also 函数 ， 如 下 所 示 : 











第 7 章 扩展 函数 和 属性 “239 * 


class Snail ( 
var name: String - "" 
var type: String - "" 
fun greet() ( 
println("Hello, I am $name") 
} 
} 


class Forest { 
var members = listOf<Sneil>() 
fun Sneil.reproduce(): Sneil = Sneil().also { 
it.name = name 
it.type = type 
members += it 


4. run 和 with 函数 


run 和 with 函数 接收 包含 接收 者 的 Lambda 字面 值 作为 参数 ， 并 于 随后 返回 其 结果 。 二 
者 间 的 差别 在 于 ，run 获取 接收 者 ， 而 with 函数 并 非 是 扩展 函数 ， 且 仅 接收 正在 操作 的 对 象 
作为 参数 。 另 外 ， 当 设置 某 个 对 象 时 ， 两 个 函数 均 可 用 作 apply 的 蔡 代 方案 ， 如 下 所 示 : 


val button = findViewById(R.id.button) as Button 


button.apply { 
text - "Click me" 
isVisible - true 
setonClickListener ( /* ... */ } 
) 


button.run ( 
text = "Click me" 
isVisible - true 
setOnClickListener ( /* ... */ } 
} 


with(button) { 
text = "Click me" 
isVisible - true 
setonClickListener ( /* ... */ } 
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apply、run 和 with 间 的 差异 主要 体现 在 : apply 返回 接收 者 对 象 ， 而 ran 和 with 则 返 
回 函数 字面 值 结 果 。 虽 然 每 个 函数 均 十 分 有 用 ， 但 在 某 些 情况 下 读者 需 对 此 有 所 选择 。 若 
无 须 任 何 返回 值 时, 究竟 使 用 哪个 函数 目前 尚 存在 争议 。 通 常情 况 下 , 建议 使 用 run 或 with 
函数 ， 其 原因 在 于 ，also 函数 常用 于 需要 使 用 到 返回 值 这 一 类 场景 。 

run 和 with 间 的 差异 可 解释 为 ， 当 某 个 值 可 空 时 ， 推 荐 使 用 run 函数 ， 而 非 with 函 
数 一 一 可 采用 安全 调用 或 非 空 断言 ， 如 下 所 示 : 


val button = findViewById(R.id.button) as? Button 







































































button?.run ( 
text = "Click me" 
isVisible - true 
setOnClickListener ( /* ... */ } 
) 


相应 地 ， 若 表达 式 较 短 ， 则 推荐 使 用 with 函数 ， 如 下 所 示 : 


val button = findViewById(R.id.button) as Button 





with(button) ( 
text - "Click me" 
isVisible - true 
setOnClickListener ( /* ... */ } 
) 


另外 ， 若 表达 式 较 长 ， 则 推荐 使 用 run 〈 而 非 with)， 如 下 所 示 : 


itemAdapter.holder.button.run ( 
text - "Click me" 
isVisible - true 
setonClickListener ( /* ... */ } 
} 


5. to FARK 

第 4 章 曾 讨论 了 中 缀 函数 ， 不 仅 可 定义 为 成 员 函 数 ， 还 可 确定 为 扩展 函数 。 相 应 地 ， 
可 针对 任意 对 象 生成 中 组 扩展 函数 。to 函数 即 是 此 类 扩展 函数 中 的 一 种 ， 第 2 章 曾 对 此 进 
行 了 简要 介绍 ， 下 面 将 考察 其 具体 实现 ， 对 应 的 定义 如 下 所 示 : 


infix fun «A, B» A.to(that: B): Pair«A, B» = Pair(this, that) 


据 此 ， 可 将 to 置 于 两 个 对 象 之 间 ， 并 通过 下 列 方式 与 Pair 结合 使 用 : 
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println( 1 to 2 == Pair(1, 2) ) // Prints: true 
注意 ， 通 过 定义 infix 扩展 函数 ， 可 将 该 函数 指定 为 任意 类 型 的 参数 ， 如 下 所 示 : 


infix fun «T» List<T>.intersection(other: List<T>) 
= filter { it in other ] 





listOf(1, 2, 3) intersection listOf(2, 3, 4) // [2,3] 


7.5.2 ”特定 领域 内 的 语言 


某 些 特性 可 定义 类 型 安全 的 构造 器 ， 例 如 Lambda 字面 值 以 及 成 员 扩展 函数 VA 
Groovy)。 其 中 , 较为 有 名 的 Android 示例 是 Gradle 配置 , 即 build.gradle, 目前 采用 Groovy 
编写 。 这 一 类 构造 器 可 视 作 XML. HTML 或 配置 文件 的 较 好 的 蔡 代 方案 。 Kotlin 的 优点 在 
于 : 可 确保 此 类 配置 类 型 安全 ， 并 提供 了 较 好 的 IDE。 此 类 构造 器 是 Kotlin 特定 领域 语言 
(DSL) 的 一 个 示例 。 

在 Android 中 ， 较 为 常见 的 Kotlin DSL 是 可 选 回调 类 的 实现 ， 并 用 于 解决 以 下 问题 : 
缺少 回调 接口 (包含 多 个 方法 ) 的 函数 式 支持 。 对 此 , 经 典 的 实现 方式 将 使 用 到 对 象 表达 ， 
如 下 所 示 : 

searchView.addTextChangedListener (object : TextWatcher { 


override fun beforeTextChanged(s: CharSequence, start: Int, count: Int, 
after: Int) {} 
























































override fun onTextChanged(s: CharSequence, start: Int, before: Int, 
count: Int) ( 
presenter.onSearchChanged (s.toString()) 
H 


override fun afterTextChanged(s: Editable) {} 
}) 
上 述 实现 的 主要 问题 包括 以 下 几 点 内 容 : 
e 须 实现 接口 中 的 全 部 方法 。 
e 须 针 对 各 个 方法 实现 函数 结构 。 
e 须 使 用 对 象 表达 。 
下 列 代码 定义 了 该 类 ， 并 将 回调 作为 可 变 属性 : 


class TextWatcherConfig : TextWatcher ( 








private var beforeTextChangedCallback: (BeforeTextChangedFunction)? = 
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private var onTextChangedCallback: (OnTextChangedFunction)? = null // 1 
private var afterTextChangedCallback: (AfterTextChangedFunction)? = null 
I i 


fun beforeTextChanged (callback: BeforeTextChangedFunction){ // 2 
beforeTextChangedCallback = callback 


fun onTextChanged (callback: OnTextChangedFunction) { // 2 
onTextChangedCallback = callback 


fun afterTextChanged (callback: AfterTextChangedFunction) { // 2 
afterTextChangedCallback = callback 


override fun beforeTextChanged (s: CharSequence?, start: Int, count: Int, 
after: Int) ( // 3 
beforeTextChangedCallback?.invoke (s?.toString(), start, count, after) 
// 4 
) 


override fun onTextChanged(s: CharSequence?, start: Int, before: 
ine, come: Ib) i ES 


onTextChangedCallback?.invoke(s?.toString(), start, before, count) // 4 


override fun afterTextChanged(s: Editable?) ( // 3 
afterTextChangedCallback?.invoke (s) 


private typealias BeforeTextChangedFunction = 

(text: String?, start: Int, count: Int, after: Int)->Unit 
private typealias OnTextChangedFunction = 

(text: String?, start: Int, before: Int, count: Int)-»Unit 


private typealias AfterTextChangedFunction = 
(s: Editable?)-»Unit 
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针对 注释 1， 当 重 载 函 数 被 调用 时 ， 将 使 用 回调 ;对 于 注释 2， 函 数 用 于 设置 新 的 回调 ， 
其 名 称 对 应 于 处 理 程序 函数 名 ， 但 将 回调 作为 参数 ， 对 于 注释 3， 各 事件 处 理 程序 函数 调 
调 CEFE); 对 于 注释 4， 为 了 进一步 简化 应 用 ， 还 须 对 类 型 进行 调整 。 原 始 方法 中 
的 CharSequence 被 修改 为 String。 

当前 ， 全 部 任务 集中 于 扩展 函数 ， 并 用 于 简化 回调 配置 。 注 意 ， 其 名 称 不 可 等 同 于 
TextView 的 名 称 。 全 部 工作 仅 须 稍 作 调整 即 可 ， 如 下 所 示 : 

fun TextView.addonTextChangedListener (config: TextWatcherConfig. ()->Unit) 

: val textWatcher = TextWatcherConfig() 

textWatcher.config() 


addTextChangedListener (textWatcher) 
) 


根据 这 一 定义 ， 可 通过 下 列 方式 定义 所 需 回调 ， 如 下 所 示 : 


searchView.addonTextChangedListener { 
onTextChanged ( text, start, before, count -> 
presenter.onSearchChanged (text) 






































E 
































可 
































5 
) 


里 ， 可 采用 下 划 线 隐藏 未 用 参数 ， 并 对 实现 过 程 加 以 改进 ， 如 下 所 示 : 


searchView.addOnTextChangedListener ( 
onTextChanged { text, , , > 
presenter.onSearchChanged (text) 





} 
} 
当前 忽略 了 两 个 
他 实现 ， 如 下 所 示 : 
searchView.addonTextChangedListener { 


beforeTextChanged { , , , => 
Log.i (TAG, "beforeTextChanged invoked") 














i 
in 





他 回调 ， 即 beforeTextChanged 和 afterTextChanged， 但 仍 可 添加 











} 
onTextChanged { text, , , => 
presenter.onSearchChanged (text) 
} 
afterTextChanged { 
Log.i(TAG, "beforeTextChanged invoked") 
} 
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通过 该 方式 定义 的 监听 器 包含 下 列 属性 : 
e 相 比 于 对 象 表达 实现 更 加 简短 。 
e 涵盖 了 默认 函数 实现 。 
e 可 隐藏 未 用 参数 。 
虽然 Android SDK 中 存在 多 种 包含 多 个 处 理 程序 的 监听 器 ， 但 可 选 回调 类 的 DSL Sc 
现在 Android 中 则 更 为 常用 。 另 外 ， 库 中 还 包含 了 类 似 的 实现 ， 例 如 之 前 提 及 的 Anko。 
DSL 用 于 定义 布局 结构 ， 且 无 须 使 用 XML 布局 文件 。 下 面 将 定义 一 个 函数 ， 添 加 并 
配置 LinearLayout 和 TextView， 并 以 此 确定 简单 的 视图 ， 如 下 所 示 : 
fun Context.linearLayout(init: LinearLayout.() -> Unit): LinearLay out { 
val layout - LinearLayout (this) 
layout.layoutParams = LayoutParams (WRAP CONTENT, WRAP CONTENT) 


layout.init() 
return layout 

































































) 


fun ViewGroup.linearLayout(init: LinearLayout.() -» Unit): LinearLayout 
t 
val layout - LinearLayout (context) 
layout.layoutParams - LayoutParams (WRAP CONTENT, WRAP CONTENT) 
layout.init() 
addView (layout) 
return layout 
} 


fun ViewGroup.textView(init: TextView.() -> Unit): TextView { 
val layout = TextView (context) 
layout.layoutParams = LayoutParams (WRAP CONTENT, WRAP CONTENT) 
layout.init() 
addView (layout) 
return layout 


// Usage 
class MainActivity : AppCompatActivity() ( 


override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate (savedInstanceState) 
val view = linearLayout { 
orientation - LinearLayout.VERTICAL 
linearLayout ( 
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orientation = LinearLayout.HORIZONTAL 
teztViow 1 tokt = i TATE 
textviow { test = "B" } 

} 


linearLayout { 
orientation = LinearLayout.HORIZONTAL 


textView { text = "C" } 
textView { text = "D" } 


} 


} 
setContentView (view) 


) 

另外 ， 还 可 从 头 开始 自 定义 DSL， 下 面 将 定义 一 个 简单 的 DSL 进而 确定 文章 列表 。 
如 前 所 述 ， 每 一 篇 文章 应 在 不 同 的 分 类 中 定义 ， 并 包含 自身 的 名 称 、URL 和 标签 。 相 关 定 
义 如 下 所 示 : 


category ("Kotlin") { 











post { 
name = "Awesome delegates" 
url = "SomeUrl.com" 

} 

post { 
name = "Awesome extensions" 
url = "SomeUrl.com" 


} 
} 
category ("Android") { 
post ( 
name = "Awesome app" 
url = "SomeUrl.com" 
tags - listOf("Kotlin", "Google Login") 


) 


此 处 ， 最 为 简 和 
所 示 : 
class Post { 
var name: String = "" 


var url: String - "" 
var tags: List<String> = listOf() 


的 对 象 是 Post 类 ， 该 类 加 载 了 跟 帖 属性 并 可 在 后 续 操 作 中 予以 修改 ， 如 下 
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随后 ， 还 须 定义 加 载 当前 分 类 的 数据 类 ， 进 而 存储 跟 帖 列表 及 其 名 称 。 除 此 之 外 ， 还 
须 定义 一 个 函数 用 以 添加 简单 的 帖子 。 该 函数 须 包 含 一 个 函数 参数 ， 其 中 ，Post 表示 为 接 
收 者 类 型 。 对 应 定义 如 下 所 示 : 


class PostCategory(val name: String) { 
var posts: List<Post> = listof() 


























fun post(init: Post.()-»Unit) ( 
val post - Post() 
post.init() 
posts += post 


) 
另外 ， 还 应 定义 一 个 类 加 载 分 类 列表 ， 并 支持 简单 的 分 类 定义 ， 如 下 所 示 : 


class PostList ( 





var categories: List«PostCategory» = listOf() 


fun category (name: String, init: PostCategory.()->Unit) ( 
val category - PostCategory (name) 
category.init() 
categories += category 


} 
当前 ， 全 部 所 需 任务 集中 于 definePosts 函数 ， 其 定义 如 下 所 示 : 


fun definePosts (init: PostList.()->Unit): PostList { 
val postList = PostList() 
postList.init() 
return postList 

5 


至 此 ， 可 通过 简单 、 类 型 安全 的 构造 器 定义 对 象 结构 ， 如 下 所 示 : 


val postList = definePosts ( 
category("Kotlin") ( 





post ( 
name = "Awesome delegates" 
url — "SomeUrl.com" 

d 

post ( 


name — "Awesome extensions" 
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url = "SomeUrl.com" 
H 


) 
category ("Android") { 


post ( 
name — "Awesome app" 
url — "SomeUrl.com" 


tags = listOf("Kotlin", "Google Login") 


) 
DSL 是 一 类 功能 强大 的 概念 ， 越 来 越 多 地 用 于 Kotlin 社区 中 。 同 时 ，Kotlin 已 完全 丛 


代 了 下 列 内 容 : 


e Android 布局 文件 (Anko)。 

e Gradle 配置 文件 。 

e HTML 文件 (kotlinx.html)。 

e JSON 文件 (Kotson)。 

下 面 讨论 相 关 的 示例 库 ， 定 义 Kotlin DSL 进而 提供 类 型 安全 的 构造 器 。 

Anko 提供 了 DSL 进而 定义 Android 视图 ， 且 无 须 使 用 XML 布局 。 这 与 之 前 讨论 的 





某 些 示例 十 分 相似 ， 但 Anko 可 完全 替代 项 目 中 的 XML 布局 文件 。 下 列 代码 显示 了 Anko 
DSL 中 编写 的 视图 示例 : 


使 


verticalLayout { 
val name = editText() 
button("Say Hello") ( 
onClick ( toast("Hello, ${name.text}!") } 
} 
} 


对 应 结果 如 图 7.8 所 示 EKF https://github.com/Kotlin/anko )。 











图 7.8 
通过 Anko DSL， 还 可 定义 更 加 复杂 的 布局 ， 此 类 视图 可 置 于 自 定义 类 中 以 作为 视图 






































， 或 者 直接 置 于 onCreate 方法 中 ， 如 下 所 示 : 
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override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 


verticalLayout ( 
padding = dip(30) 
editText ( 
hint = "Name" 
textSize = 24f 
) 
editText ( 
hint = "Password" 
textSize = 24f 
) 
button("Login") { 
textSize = 26f 
) 


) 


& 读者 可 访问 Anko Wiki 以 获取 更 多 内 容 ， 对 应 网 址 为 https://github. 
com/Kotlin/anko/wiki/ Anko-Layonuts。 


XT DSL 布局 定义 是 否 可 替代 XML 定义 ， 目 前 尚 存 争议 。 在 本 书 编写 时 ， 此 类 视 
定义 方式 较 少 使 用 。 目 前 尚 缺少 Google 的 支持 。 但 Google 宣布 将 对 Kotlin 予以 支持 。 
此 ， 这 一 概念 将 会 变 得 更 加 流行 ，DSL 布局 也 将 赢得 更 多 的 支持 ， 甚 至 有 可 能 成 为 通 
定义 。 
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76 本 章 小 结 


本 章 讨 论 了 Kotlin 中 的 扩展 函数 和 属性 ， 二 者 均 定义 为 顶级 和 类 型 成 员 。 另 外 ， 本 章 
还 介绍 了 Kotlin 标准 库 扩展 函数 的 使 用 方式 ， 进 而 可 简化 集合 处 理 并 执行 各 项 操作 。 同 时 
也 考察 了 基于 接收 者 的 函数 类 型 ， 以 及 基于 接收 者 的 函数 字面 值 。 一 些 较为 重要 的 标准 库 
泛 型 函数 (采用 了 扩展 ) 包括 let. apply. also. with, run 以 及 to。 最后， 本章 还 探讨 了 
Kotlin 中 DSL 的 定义 方式 以 及 应 用 场合 。 

第 8 章 将 讨论 Java 中 未 涉及 的 特性 , 此 类 特性 在 Kotlin 开发 中 则 十 分 常见 , 即 类 和 属 
性 的 委托 。 
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Kotlin 从 设计 模式 中 借鉴 了 大 量 内 容 。 前 述 章节 曾 讨论 了 如 何 使 用 单 例 模式 简化 对 象 
声明 , 以 及 观察 者 模式 的 简化 方式 (依据 高 阶 函 数 和 函数 类 型 )。 除 此 之 外 , 借助 于 Lambda 
表达 式 和 函数 类 型 ，Kotlin 还 简化 了 大 多 数 函数 模式 应 用 。 本 章 将 考察 基于 类 委托 的 委托 
模式 和 装饰 器 模式 。 除 此 之 外 ， 本 章 还 将 介绍 一 种 全 新 的 特性 一 一 属性 委托 ， 及 其 使 用 方 
式 ， 进 而 增强 Kotlin 中 的 属性 功能 。 

本 章 主要 涉及 以 下 内 容 : 

e 委托 模式 。 

e 类 委托 。 

e 装饰 器 模式 。 

e 属性 委托 。 

e 源 自 标准 库 的 属性 委托 。 

。 构建 自 定义 属性 委托 。 
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Kotlin 中 包含 了 一 种 称 之 为 类 委托 的 特性 ， 该 特性 并 不 显著 ,但 其 实际 应 用 范围 则 较 
广 。 注 意 ， 类 委托 与 两 种 设计 模式 关系 紧密 ， 即 委托 模式 和 装饰 器 模式 。 下 面 将 详细 讨论 
这 两 种 模式 。 委 托 模式 和 装饰 器 模式 已 经 存在 了 很 长 时 间 ， 在 Java 中 ， 其 实现 需要 使 用 到 
大 量 的 样板 代码 。 对 于 此 类 模式 ，Kotlin 则 提供 了 本 地 支持 ， 并 将 样板 代码 降 至 最 低 。 


8.1.1 委托 模式 


在 面向 对 象 程序 设计 中 ， 委 托 模式 是 继承 的 一 种 替代 方案 。 也 就 是 说 ， 对 象 通过 将 其 
委托 至 另 一 个 对 象 (RH) 进而 处 理 某 个 请 求 ， 而 不 是 扩展 该 类 。 

为 了 支持 Java 中 的 多 态 机 制 ,两 个 对 象 须 实现 在 全 部 委托 方法 和 属性 的 同一 接口 。 下 
列 代码 展示 了 委托 模式 的 简单 示例 。 


interface Player { // 1 
fun playGame () 





























} 


class RpgGamePlayer(val enemy: String) : Player { 
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override fun playGame() ( 
println("Killing $enemy") 
) 
} 


class WitcherPlayer (enemy: String) : Player { 
val player = RpgGamePlayer(enemy) // 2 
override fun playGame() ( 
player.playGame() // 3 
} 
} 


// Usage 
RpgGamePlayer ("monsters") .playGame() // Prints: Killing monsters 
WitcherPlayer ("monsters") .playGame() // Prints: Killing monsters 


针对 注释 1， 当 考察 类 委托 时 ， 须 设置 一 个 接口 并 定义 委托 方法 ; 在 注释 2 中 ， 设 置 了 
委托 的 对 象 ， 对 于 注释 3，WitcherPlayer 中 的 全 部 方法 应 调用 委托 对 象 (player) 上 的 对 


应 方法 。 
于 WitcherPlayer 类 将 定义 于 Player 接口 中 的 方法 委托 至 RpgGamePlayer (player) 类 



































型 接口 。 通 过 继承 机 制 〈 而 非 委 托 ) 也 可 实现 类 似 的 结果 ， 如 下 所 示 : 


class WitcherPlayer() : RpgGamePlayer() 











初 看 之 下 ， 两 种 方案 彼此 相似 ， 但 实际 上 ， 委 托 和 继承 机 制 包 含 了 许多 差异 。 一 方面 ， 














继承 机 制 在 Java 中 更 为 常见 ， 且 与 多 种 OOP 模式 关系 紧密 。 另 外 一 方面 ， 委 托 机 制 也 涉 


及 了 大 量 内 容 ， 例 如 Gang of Four 编写 的 Design Patterns 一 书 便 极 具 影响 














J. PPH: 


优先 使 用 对 象 组 合 ， 而 非 继承 ; 而 在 另 一 本 知名 著作 Effective Java 中 则 提 到 : 优先 使 用 组 
合 ， 而 非 继承 〈 第 6 项 )。 由 此 可 见 ， 二 者 均 对 委托 机 制 提出 了 强 有 力 的 支持 。 委 托 模式 
下 的 基本 观点 包括 : 
。 通常 情况 下 ， 类 针对 继承 机 制 而 设计 。 当 覆 写 方法 时 ， 人 们 通常 不 会 关注 与 类 内 部 
行为 相关 的 底层 假设 条 件 〈 当 方法 被 调用 时 ， 该 调用 对 对 象 、 状 态 等 的 影响 方式 )。 
例如 ， 当 覆 写 某 个 方法 时 ,可 能 并 不 会 意识 到 该 方法 还 将 被 其 他 方法 所 使 用 。 因 此， 
履 写 后 的 方法 可 能 被 超 类 以 一 种 不 确定 的 方式 被 调用 。 即 使 对 该 方法 调用 进行 检 
测 , 该 行为 仍 会 导致 在 当前 类 的 某 个 新 版 本 中 产生 变化 (例如 , 从 外 部 库 中 扩展 类 )， 
从 而 破坏 子 类 的 行为 。 针 对 继承 ， 一 般 会 适当 涉及 少量 的 类 ， 但 几乎 所 有 非 抽 象 类 








针对 具体 应 用 〈 包 括 委托 ) 而 加 以 设计 。 
e 在 Java 中 ， 可 能 会 将 某 个 类 托管 至 多 个 类 中 ， 但 仅 从 一 个 类 中 继承 。 
e 通 过 接口 ， 可 指定 需要 托管 的 方法 和 属性 ， 这 与 接口 分 离 机 制 保持 一 致 
























































不 可 向 
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客户 端 暴 露 不 必要 的 方法 。 

e 某 些 类 会 定义 为 final， 因 而 仅 可 委托 至 其 中 。 实 际 上 ， 未 针对 继承 设计 的 所 有 类 均 
应 为 final。Kotlin 设计 者 已 认识 到 这 一 问题 ， 默 认 条 件 下 ，Kotlin 中 的 全 部 类 均 为 
final。 

o 针对 公有 库 ， 将 某 个 类 指定 为 final 并 提供 相应 的 接口 可 视 为 一 种 较 好 的 操作 方法 。 
对 此 ， 可 调整 类 实现 ， 且 无 须 担 心 会 影响 到 库 用 户 〈 从 接口 角度 来 看 ， 只 要 行为 保 
持 一 致 即 可 )。 因 此 ， 这 也 使 得 继承 操作 不 再 可 行 ， 但 仍 是 委托 目标 的 最 佳 候选 。 




















关于 类 的 设计 方式 进而 支持 继承 机 制 , 以 及 何 时 应 使 用 委托 ,读者 可 参 
考 Effective Java 一 书 中 的 第 16 项 : 优先 使 用 组 合 ， 而 非 继承 。 


当然 ， 委 托 机 制 也 存在 某 些 缺 点 ， 其 中 包括 : 
e 需要 创建 接口 ， 以 指定 应 委托 的 方法 。 
e 无 法 访问 受 保护 的 方法 和 属性 。 
在 Java 中 ， 关 于 使 用 继承 问题 ， 仍 存在 某 些 激烈 的 争论 一 一 继承 更 易于 实现 。 对 此 ， 
可 比较 WitcherPlayer 示例 代码 ， 不 难 发 现 ， 委 托 中 涵盖 了 较 多 的 附加 代码 ， 如 下 所 示 : 

class WitcherPlayer (enemy: String) : Player { 

val player = RpgGamePlayer (enemy) 

override fun playGame() ( 

player.playGame|() 

) 

} 


class WitcherPlayer() : RpgGamePlayer () 


当 处 理 包含 多 个 接口 的 方法 时 ， 这 将 产生 问题 。 然 而 ， 现 代 编程 语言 均 十 分 重视 委托 设计 
模式 ， 大 多 数 语言 设置 了 本 地 类 委托 支持 。 例 如 ，Swift 和 Groovy 对 委托 模式 均 提供 了 强 
大 的 支持 ，Ruby 语言 则 通过 其 他 机 制 对 此 了 予以 支持 ， 并 简化 了 该 模式 的 应 用 ， 同 时 使 得 
样板 代码 数量 降 至 最 低 。 这 里 , 示例 中 的 WitcherPlayer 类 在 Kotlin 中 可 通过 下 列 方式 实现 : 


class WitcherPlayer(enemy: String) : Player by RpgGamePlayer(enemy) () 


当 使 用 by 关键 字 时 ， 即 通知 编译 器 ， 将 定义 于 Player 接口 中 的 全 部 方法 从 Witcher 
Player 委托 至 RpgGamePlayer。RpgGamePlayer 将 在 WitcherPlayer 构造 过 程 中 创建 。 简 而 
言 之 ，WitcherPlayer 将 定义 于 Player 接口 中 的 方法 委托 至 新 的 RpgGamePlayer 对 象 中 。 

在 编译 器 过 程 中 , Kotlin 编译 器 将 生成 WitcherPlayer 中 源 自 Player 的 、 未 实现 的 方法 ， 
并 利用 RpgGamePlayer 实例 调用 对 其 填充 〈 该 方式 与 第 一 个 示例 中 的 实现 方式 相同 )。 这 
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有 体现 了 一 处 重大 改进 : 无 须 亲 自 实现 此 类 方法 。 另 外 须 注意 的 是 ， 如 果 委 托 方法 签名 发 
变化， 无 须 修改 委托 至 其 中 的 全 部 对 象 ， 因 而 对 应 类 易于 维护 。 

除 此 之 外 ， 还 存在 另 一 种 委托 实例 的 创建 和 加 载 方式 ， 并 通过 构造 函数 予以 提供 ， 如 
下 所 示 : 
class WitcherPlayer (player: Player) : Player by player 

同时 ， 还 可 委托 至 定义 于 构造 函数 中 的 属性 中 ， 如 下 所 示 
class WitcherPlayer(val player: Player) : Player by player 
最 后 ， 还 可 在 类 声明 时 委托 至 任意 可 访问 的 属性 中 ， 如 下 所 示 : 


val d = RpgGamePlayer (10) 
class WitcherPlayer(a: Player) : Player by d 


而 且 ， 一 个 对 象 可 包含 多 个 不 同 的 委托 ， 如 下 所 示 : 


interface Player ( 
fun playGame () 








Lr oum 

















) 


interface GameMaker ( // 1 
fun developGame () 
) 


class WitcherPlayer(val enemy: String) : Player ( 
override fun playGame() ( 
print ("Killin $enemy! ") 
} 
H 


class WitcherCreator(val gameName: String) : GameMaker( 
override fun developGame() ( 
println ("Makin $gameName! ") 
} 
ji 


class WitcherPassionate : 
Player by WitcherPlayer ("monsters"), 
GameMaker by WitcherCreator ("Witcher 3") { 


fun fulfillYourDestiny() { 
playGame () 
developGame () 
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} 


// Usage 
WitcherPassionate().fulfillYourDestiny() // Killin monsters! Makin 
Witcher 3! 
针对 注释 1, WitcherPlayer 类 将 Player 接口 委托 至 新 的 RpgGamePlayer 对 象 中 ， 将 
GameMaker 委托 至 WitcherCreator 对 象 中 ， 另 外 还 包含 了 fulfillYourDestiny 函数 (该 函数 
使 用 了 源 自 两 个 委托 中 的 函数 )。 注 意 ，WitcherPlayer 和 WitcherCreator 均 未 标记 为 open， 
虽然 可 被 委托 ， 但 无 法 被 扩展 。 
通过 编程 语言 方面 的 支持 ， 与 继承 机 制 相 比 ， 委 托 更 具 吸 引力 。 尽 管 此 类 模式 包 
含 相应 的 优 缺 点 ， 但 读者 应 了 解 何 时 使 用 这 一 类 模式 。 下 列 内 容 列 举 了 一 些 委托 的 应 
He: 
e 当 子 类 与 里 氏 蔡 换 规则 冲突 时 ， 例 如 ， 继 承 仅 实现 为 复 用 超 类 代码 时 ， 但 实际 行为 
并 不 与 其 相符 。 
e 当 子 类 仅 使 用 超 类 中 的 部 分 方法 时 。 其 中 , 可 能 会 调用 一 个 不 应 该 调用 的 超 类 方法 。 
当 采 用 委托 机 制 时 ， 可 复 用 所 选取 的 方法 (定义 于 当前 接口 中 )。 
e 当 无 法 或 不 应 使 用 继承 时 ， 其 中 包括 : 
K 类 定义 为 final。 
He 相对 于 接口 无 法 访问 或 使 用 。 
Ke 未 针对 继承 而 设计 。 
注意 ， 默 认 状 态 下 Kotlin 中 的 类 表示 为 fnal， 如 果 将 其 置 于 某 个 库 中 ， 则 很 可 能 无 法 
修改 或 打开 该 类 ; 而 委托 仅 可 视 作 是 一 个 选项 ， 进 而 创建 包含 不 同行 为 的 类 。 
里 氏 蔡 换 规则 是 OOP 程序 设计 中 的 概念 ， 其 中 , 全 部 子 类 的 行为 都 应 该 像 它们 的 超 
类 一 样 。 简 单 地 讲 , 如 果 某 个 类 通过 单元 测试 , 则 其 子 类 也 应 通过 该 测试 。 该 原则 由 Robert 
C. Martin 提出 ， 并 作为 较为 重要 的 编程 规则 之 一 ， 具 体内 容 可 参考 Cean Code 一 书 。 
Effective Java 一 书 中 曾 讲 到 : 仅 当 子 类 真正 地 表示 为 超 类 的 子 类 型 时 ， 继 承 机 制 方 为 
适宜 。 换 而 言 之 , 仅 当 两 个 类 之 间 存 在 is 关系 时 ， 类 B 方 可 扩展 某 个 类 。 如 果 视 图 令 类 B 
扩展 类 A， 则 应 首先 询问 自己 : 每 个 B 是 否 真正 是 A? 稍 后 将 介绍 ， 在 其 他 情况 下 ， 建 议 
使 用 组 合 机 制 。 
值得 注意 的 是 ，Cocoa (Apple 的 UI 框架 ， 用 以 构建 软件 程序 并 在 iOS 上 运行 ) 常 采 
委托 ， 而 非 继承 机 制 。 该 模式 变 得 越 来 越 流行 ，Kotlin 也 对 此 提供 了 强大 的 支持 。 
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8.1.2 ”装饰 器 模式 


在 Kotlin 中 ， 类 委托 机 制 的 另 一 个 用 武之 地 是 在 实现 装饰 器 模式 时 。 装 饰 器 模式 〈 也 
称 作 包 装 器 模式 ) 可 向 现 有 类 中 加 入 某 种 行为 ， 且 无 须 采 用 继承 操作 。 相 比 于 扩展 (可 添 
加 新 行为 ， 且 不 需要 调整 对 象 )， 此 处 将 构建 一 个 包含 不 同行 为 的 具体 对 象 。 装 饰 器 模式 


























使 用 了 委托 机 制 ， 但 却 采 取 了 一 种 较为 特殊 的 方式 一 委托 来 自 于 类 的 外 部 。 图 8.1 显示 

















了 经 典 的 UML 图 。 


装饰 器 中 包含 了 所 装饰 的 对 象 ， 同 时 实现 了 同一 接口 。 
InputStream 则 是 Java 中 较为 常见 的 装饰 器 示例 。 对 此 ， 存 在 不 同类 型 扩展 了 
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图 8.1 




















InputStream， 同 时 存在 多 种 装饰 器 可 用 于 向 其 添加 功能 项 。 该 装饰 器 可 用 于 添加 缓冲 区 、 
获取 压缩 文件 中 的 内 容 , 或 者 将 文件 内 容 转 换 为 Java 对 象 。 在 下 列 示例 中 ,使 用 了 多 个 装 
饰 器 以 读 取 压 缩 Java 对 象 。 





// Java 








FileInputStream fis = new FileInputStream("/someFile.gz"); // 1 
BufferedInputStream bis = new BufferedInputStream(fis); // 2 
GzipInputStream gis = new GzipInputStream(bis); // 3 
ObjectInputStream ois = new ObjectInputStream(gis); // 4 
SomeObject someObject = (SomeObject) ois.readObject(); // 5 


对 于 注释 1， 针 对 文件 读 取 创 建 一 个 简单 的 流 ; 针对 注释 2， 生 成 一 个 包含 缓冲 区 的 新 流 ; 








ADHERE, A 








成 一 个 新 的 流 ， 其 中 包含 了 读 取 GZIP 文件 格式 的 压缩 数据 ;针对 注释 4, 
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生成 一 个 新 流 并 添加 一 个 功能 项 ， 用 于 反 序 列 化 之 前 采用 ObjectOutputStream 编写 的 基本 
数据 和 对 象 ， 针 对 注释 5， 流 用 于 ObjectInputStream 的 readObject 方法 中 ， 但 该 示例 中 的 
全 部 对 象 均 实现 于 InputStream 中 (因而 有 可 能 通过 这 一 方式 对 其 进行 打包 )， 并 可 通过 当 
前 接口 所 定义 的 方法 所 读 取 。 

需要 注意 的 是 ， 上 述 模 式 与 继承 类 似 ， 但 却 可 确定 所 用 的 装饰 器 及 其 顺序 ， 因 而 在 应 
过 程 中 体现 了 更 大 的 灵活 性 以 及 更 多 的 可 能 性 。 一 些 人 认为 ， 如 果 设 计 者 定义 一 个 包含 
全 部 设计 功能 的 大 型 类 ， 随 后 使 用 相关 方法 开启 或 关闭 其 中 的 某 些 功能 ， 将 会 更 好 地 运用 
InputStream。 实 际 上 ， 该 方案 违背 了 单一 职责 原则 ， 从 而 导致 代码 更 加 复杂 且 难 以 扩展 。 

在 实际 操作 过 程 中 , 虽然 装饰 器 模式 可 视 作 一 种 最 佳 方案 , 但 在 Java 项 目 中 却 较 少 使 
， 其 原因 在 于 : 具体 实现 过 程 相对 复杂 。 接 口中 一 般 涵盖 多 个 方法 ， 为 其 在 每 个 装饰 器 
中 创建 一 个 委托 ， 将 产生 大 量 的 样板 代码 。 在 Kotlin H, HHN 
讨论 ，Kotlin 中 的 类 委托 机 制 实际 上 十 分 简单 。 下 面 考 察 装饰 器 模式 中 类 委托 机 制 的 某 些 
经 典 示 例 , 假设 需要 向 多 个 不 同 的 ListAdapter 添加 第 一 个 位 置 作为 0 元 素 。 这 一 额外 的 位 

包含 了 某 些 特定 属性 。 对 此 ， 无 法 采用 继承 机 制 予 以 实现 一 一 针对 不 同 列表 的 
ListAdapter 具有 不 同 的 类 型 (这 也 是 一 类 标准 情形 )。 此 处 ， 可 调整 各 个 类 的 行为 (DRY 
规则 )， 或 者 生成 一 个 装饰 器 。 该 装饰 器 的 简短 代码 如 下 所 示 : 


class ZeroElementListDecorator(val arrayAdapter: ListAdapter) : 
ListAdapter by arrayAdapter ( 























zu 





































































































override fun getCount(): Int = arrayAdapter.count + 1 
override fun getItem(position: Int): Any? = when ( 
position == 0 -> null 


else -> arrayAdapter.getItem(position - 1) 
) 


override fun getView(position: Int, convertView: View?,parent: 
ViewGroup): View = when ( 
position == 0 -> parent.context.inflator 
.inflate(R.layout.null element layout, parent, false) 
else -» arrayAdapter.getView(position - 1, convertView, parent) 
} 
} 


override fun getItemId(position: Int): Long = when { 
position == 0 -> 0 
else -> arrayAdapter.getItemId(position - 1) 

H 
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此 处 使 用 了 Context 中 的 inflator 扩展 属性 ， 该 属性 通常 包含 于 Kotlin Android 项 目 中 ， 相 
关内 容 可 参考 第 7 章 。 对 应 代码 如 下 所 示 : 


val Context.inflater: LayoutInflater 
get() = LayoutInflater.from(this) 














通过 该 方式 定义 的 ZeroElementListDecorator 类 将 添加 包含 静态 视图 的 第 一 个 元 素 , 其 应 用 
方式 如 下 所 示 : 


val arrayList = findViewById(R.id.list) as ListView 

val list = listOf("A", "B", "C") 

val arrayAdapter = ArrayAdapter (this, 
android.R.layout.simple list item 1, list) 

arrayList.adapter = ZeroElementListDecorator (arrayAdapter) 























在 ZeroElementListDecorator 中 , 代码 看 上 去 稍 显 复杂 , 因而 需要 覆 写 4 个 方法 ,但 实际 上 ， 
鉴于 Kotlin 的 委托 机 制 ， 至 少 存 在 8 个 方法 且 无 须 覆 写 。 不 难 发 现 ，Kotlin 的 类 委托 机 制 
大 大 简化 了 装饰 器 模式 的 实现 过 程 。 

装饰 器 模式 易于 实现 ， 且 具有 较 好 的 直观 性 ， 同 时 还 可 用 于 多 种 不 同 的 场合 ， 以 扩展 
包含 附加 功能 的 某 个 类 。 鉴 于 其 安全 性 ， 因 而 该 模式 具备 较 好 的 安全 特性 ， 并 作为 一 类 和 良 
好 的 操作 加 以 引用 。 此 类 示例 仅 体现 了 类 委托 的 部 分 可 能 性 ， 更 多 的 、 基 于 所 述 模式 的 用 
例 ， 以 及 类 委托 机 制 的 应 用 ， 尚 等 待 读者 进一步 发 现 ， 以 使 项 目 更 加 清晰 、 安 人 全、 简洁。 


82 属性 委托 

















除了 类 委托 之 外 , Kotlin 还 支持 属性 委托 。 本 节 主 要 讨论 属性 委托 的 含义 , 考察 Kotlin 
标准 库 中 的 属性 委托 机 制 ， 并 学 习 如 何 创建 和 使 用 自 定义 属性 委托 。 


8.2.1 属性 委托 的 含义 
下 面 首先 解释 属性 委托 的 含义 ， 其 应 用 示例 如 下 所 示 : 


class User (val name: String, val surname: String) 














var user: User by UserDelegate() // 1 


println (user.name) 
user = User("Marcin", "Moskala") 





对 于 注释 1， 此 处 将 user 属性 委托 至 UserDelegate 的 实例 〈 用 构造 函数 创建 ) 中 。 
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属性 委托 与 类 委托 有 几 分 相似 ， 通 过 相同 的 关键 字 (by)， 可 委托 至 某 个 对 象 中 。 某 
属性 的 每 次 调用 (set/get) 将 委托 至 另 一 个 对 象 (UserDelegate)。 通 过 这 一 方式 ， 可 针对 
多 个 属性 复 用 同一 行为 。 例 如 ， 仅 当 满 足 某 种 场合 时 设置 属性 值 ; 或 者 在 属性 被 访问 /更 新 
时 添加 日 志 项 。 

实际 上 , 属性 并 不 需要 幕后 字段 (backing field), 可 能 仅 通过 getter( 只 读 ) 或 getter/setter 
( 读 - 写 ) 加 以 定义 。 从 底层 角度 来 看 ， 属 性 委托 仅 被 转换 为 对 应 的 方法 调用 CsetValue/ 
getValue )。 此 时 ， 上 述 示例 将 被 编译 为 下 列 代码 : 


var p$delegate = UserDelegate () 
var user: User 
get() = p$delegate.getValue(this, ::user) 
set(value) ( 
p$delegate.setValue(this, ::user, value) 




















) 


该 示例 表明 ， 通 过 使 用 by 关键 字 ， 将 setter 和 getter 调用 委托 至 delegate。 这 也 解释 了 包 
含 getValue 和 setValue 函数 〈 设 置 了 正确 的 参数 ， 稍 后 将 对 此 加 以 讨论 ) 的 任意 对 象 可 用 
作 委 托 〈 针 对 只 读 属 性 getValue 已 然 足够 ， 由 于 此 处 仅 需要 getter)。 重 要 的 是 ， 须 用 作 属 
性 委托 的 全 部 类 将 包含 这 两 个 方法 ， 同 时 无 须 使 用 到 接口 。UserDelegate 的 实现 示例 如 下 
所 示 : 
class UserDelegate { 
operator fun getValue(thisRef: Any?, property: KProperty<*>): 
User - readUserFromFile() 
operator fun setValue(thisRef: Any?, property: KProperty<*>, 


user:User) ( 
saveUserToFile (user) 




















} 
yes 
5 
setValue 和 getValue 由 于 设置 和 获取 属性 值 (属性 的 setter 调用 委托 至 setValue 方法 ; 属性 
getter 将 数值 委托 至 getValue 方法 )。 两 个 函数 均 需要 采用 operator 关键 字 ， 同 时 包含 了 一 
些 特定 的 参数 集合 ， 这 些 参数 决定 委托 的 位 置 和 属性 。 如 果 某 个 属性 表示 为 只 读 ， 那 么 对 
象 仅 须 包含 一 个 getValue 方法 并 用 作 其 委托 ， 如 下 所 示 : 


class UserDelegate { 


operator fun getValue(thisRef: Any?, property: KProperty<*>): 
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User = readUserFromFile() 
} 


getValue 方法 的 返回 类 型 以 及 属性 的 类 型 〈 用 户 定义 于 setValue 方法 中 ) 决定 了 委托 属性 
的 类 型 。 
getValue 和 setValue 函数 的 第 一 个 参数 (thisRef) 包含 了 委托 所 用 的 上 下 文 的 引用 ， 
并 可 用 于 委托 所 用 的 类 型 。 例 如 ， 可 通过 下 列 方式 定义 仅 在 Activity 类 中 使 用 的 委托 : 
class UserDelegate ( 
operator fun getValue(thisRef: Activity, property: KProperty«*»): 


User = thisRef.intent 
-getParcelableExtra ("com.example.UserKey") 



























































} 
从 中 可 以 看 到 ， 此 处 存在 一 个 全 部 上 下 文 提供 的 this 引用 。 仅 在 扩展 函数 内 部 ， 或 扩展 
属性 上 才 存 在 null 值 。 指 向 this 的 引用 用 于 获取 某 些 来 自 上 下 文 的 数据 。 如 果 将 其 设置 
为 Activity 类 型 , 则 可 仅 在 Activity 中 使 用 该 委托 (在 this X Activity 的 任意 上 下 文中 )。 

除 此 之 外 ， 若 需要 强制 当前 委托 仅 用 于 顶级 位 置 ， 则 可 将 第 一 个 参数 ChisReD 的 类 
型 指定 为 Nothing? 一 一 该 类 型 的 唯一 可 能 值 为 null。 

上 述 方法 中 的 另 一 个 参数 为 property， 包 含 了 指向 委托 属性 的 一 个 引用 ， 其 中 涵盖 了 
其 元 数据 (属性 名 以 及 类 型 等 )。 

属性 委托 可 用 于 定义 于 任意 上 下 文中 的 属性 (顶级 属性 、 成 员 属性 以 及 局 部 属性 等 )， 
如 下 所 示 : 

var a by SomeDelegate() // 1 














fun someTopLevelFun() { 
var b by SomeDelegate() // 2 
} 


class SomeClass() { 
var c by SomeDelegate() // 3 


fun someMethod() { 
val d by SomeDelegate() // 4 
} 
} 
对 于 注释 1， 基 于 委托 的 顶级 属性 ， 对 于 注释 2， 包含 委托 的 局 部 属性 (在 顶级 函数 中 ); 
对 于 注释 3， 包 含 委 托 的 成 员 属 性 。 
后 续 章节 将 讨论 Kotlin 标准 库 中 的 委托 机 制 , 并 体现 了 其 有 效 性 以 及 属性 委托 的 应 
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方式 。 
8.2.2 ”预定 义 委 托 


Kotlin 标准 库 包 含 了 一 些 属性 委托 ， 且 使 用 起 来 十 分 方便 。 下 面 讨论 其 在 实际 项 目 中 
的 使 用 方式 。 


1. lazy PARC 


某 些 时 候 ， 需 要 初始 化 某 个 对 象 ， 且 需要 确保 该 对 象 仅 初 始 化 一 次 ， 以 供 首 次 使 用 。 
在 Java 中 ， 可 通过 下 列 方式 处 理 这 一 问题 : 


private var someProperty: SomeType? = null 
private val somePropertyLock - Any() 
val someProperty: SomeType 
get() ( 
synchronized(somePropertyLock) ( 
if ( someProperty == null) ( 
someProperty = SomeType() 



























































} 
return someProperty!! 


} 
这 一 构造 过 程 是 Java 开发 中 的 常见 模式 。 通 过 延迟 Clazy) 委托 ，Kotlin 可 采用 较为 简单 
的 方式 处 理 此 类 问题 ， 这 也 是 较为 常用 的 委托 ， 且 仅 与 只 读 属 性 (val) 协同 工作 ， 对 应 的 
应 用 方式 如 下 所 示 : 
val someProperty by lazy { SomeType() } 
标准 库 中 的 lazy 函数 用 于 提供 委托 ， 如 下 所 示 : 
public fun «T» lazy(initializer: () -> T): 
Lazy<T> = SynchronizedLazyImpl (initializer) 
在 SynchronizedLazyImpl 的 示例 对 象 中 ， 该 对 象 用 作 属 性 委托 。 大 多 数 时 候 ， 它 被 称 作 源 
自 其 对 应 函数 名 的 延迟 委托 。 其 他 委托 名 称 与 提供 它们 的 函数 名 称 相同 。 
延迟 委托 同样 包含 了 线程 安全 机 制 。 黑 认 状 态 下 ， 委 托 具备 完整 的 线程 
安全 特性 ; 但 若 已 经 知晓 仅 存在 单一 线程 ， 则 可 进行 适当 调整 ， 以 使 函数 更 
加 高 效 , 为 了 关闭 线程 安全 机 制 ,需要 将 enum 类 型 值 LazyThreadSafetyMode. 
NONE 作为 lazy 函数 的 第 一 个 参数 ， 如 下 所 示 : 
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val someProperty by lazy(LazyThreadSafetyMode.NONE) ( 
SomeType() ) 


























鉴于 延迟 委托 ， 属 性 的 初始 化 操作 将 被 延迟 ， 直 至 需要 使 用 到 对 应 值 时 。 延 迟 委托 应 用 涵 
盖 了 多 个 优点 ， 其 中 包括 : 

e 快速 的 类 初始 化 可 缩短 应 用 程序 的 启动 时 间 一 一 数值 初始 化 将 被 延迟 ， 直 至 其 第 一 

次 使 用 时 。 

e 某 些 操作 流 不 会 使 用 到 相关 值 ， 因 而 无 须 对 其 进行 初始 化 一 一 这 将 极 大 地 节省 资源 

(包括 内 存 、 处 理 器 时 间 以 及 电量 )。 

除 此 之 外 ， 某 些 对 象 还 可 在 类 实例 创建 后 生成 。 例 如 ， 在 Activity 中 ， 在 使 用 set 
ContentView 方法 设置 布局 之 前 ， 将 无 法 访问 资源 一 一 一 般 将 在 onCreate 方法 中 被 调 
下 面 将 考察 包含 视图 引用 元 素 的 Java 类 ， 如 下 所 示 : 


// Java 
public class MainActivity extends Activity { 
























































T 
E] 
o 



































TextView questionLabelView 
EditText answerLabelView 
Button confirmButtonView 


GOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


questionLabelView = findViewById«TextView» 
(R.id.main question label); 

answerLabelView = findViewById«EditText» 
(R.id.main answer label); 

confirmButtonView = findViewById«Button» 
(R.id.main button confirm); 


} 
若 将 其 逐一 转换 至 Kotlin 中 ， 对 应 代码 如 下 所 示 : 
class MainActivity : Activity() { 
var questionLabelView: TextView? = null 


var answerLabelView: TextView? = null 
var confirmButtonView: Button? = null 
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override fun onCreate(savedInstanceState: Bundle) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.main activity) 


questionLabelView = findViewById<TextView> 
(R.id.main question label) 

answerLabelView = findViewById«TextView» 
(R.id.main answer label) 

confirmButtonView = findViewById«Button» 
(R.id.main button confirm) 


} 
当 采 用 延迟 委托 时 ， 可 采用 更 为 简单 的 方式 实现 这 一 行为 ， 如 下 所 示 : 


class MainActivity : Activity() { 

















val questionLabelView: TextView by lazy 

{ findViewById(R.id.main question label) as TextView } 
val answerLabelView: TextView by lazy 

( findViewById(R.id.main answer label) as TextView } 
val confirmButtonView: Button by lazy 

{ findViewById(R.id.main button confirm) as Button } 


override fun onCreate(savedInstanceState: Bundle) ( 
super.onCreate (savedInstanceState) 
setContentView(R.layout.main activity) 
} 
j 


该 方案 的 优点 在 于 : 
e 属性 集中 于 一 处 进行 声明 和 初始 化 ， 因 而 代码 将 更 加 简洁 。 
e 属性 定义 为 非 空 类 型 ， 这 可 消除 大 量 的 空 检测 操作 。 
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o 属性 具有 只 读 特征 ， 因 而 具有 线程 同步 或 智能 转换 所 蕴含 的 各 种 优点 。 
e 传递 至 延迟 委托 (包含 findViewById) 的 Lambda 仅 在 属性 首次 被 访问 时 执行 。 





e 与 类 创建 过 程 相 比 ， 数 值 将 于 稍 后 被 获得 ， 这 将 加 速 启动 过 程 。 如 果 不 打算 使 用 
类 视图 ， 对 应 值 将 不 会 被 获取 〈 若 视图 较为 复杂 时 ，findViewById 并 不 是 一 类 高 效 


的 操作 方式 )。 























e 编译 器 将 对 未 用 属性 进行 标记 。 在 Java 实现 中 ， 则 并 不 会 执行 该 操作 ， 因 为 数值 


将 被 编译 器 所 关注 。 
通过 析 取 公共 行为 ， 并 将 其 转换 为 扩展 函数 ， 可 对 上 述 实现 进行 改进 




















， 如 下 所 示 : 


pid 
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fun «T: View» Activity.bindView(viewId: Int) = lazy ( findViewById (viewId) 
as py 


随后 ， 可 通过 更 加 简洁 的 代码 定义 视图 绑 定 ， 如 下 所 示 : 


class MainActivity : Activity() ( 





var questionLabelView: TextView by bindView(R.id.main question label) 
//1 

var answerLabelView: TextView by bindView(R.id.main answer label) // 1 

var confirmButtonView: Button by bindView(R.id.main button confirm) // 
1 


override fun onCreate(savedInstanceState: Bundle) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.main activity) 
} 
} 


对 于 注释 1， 无 须 设置 供 bind View 函数 使 用 的 类 型 一 一 可 根据 属性 类 型 进行 推断 。 
目前 仅 存在 单一 委托 ， 当 首次 访问 特定 视图 时 ， 将 于 底层 调用 findViewById， 这 可 视 
作 是 一 类 相对 简洁 的 方法 。 
针对 此 类 问题 ， 还 存在 另 一 种 处 理 方式 。 当 前 较为 常用 的 方法 是 Kotlin 
qp Android 扩展 插件 ， 并 在 Activities 和 Fragments 中 生成 视图 的 自动 绑 定 。 具 
体 应 用 将 在 第 9 章 加 以 讨论 。 
即使 存在 相关 支持 ， 绑 定 机 制 自身 的 优点 仍 十 分 明显 。 例 如 ， 可 清晰 地 显示 我 们 所 用 
的 视图 元 素 ; 另外 一 点 则 是 元 素 ID 名 与 加 载 当 前 元 素 的 变量 名 可 彼此 分 离 。 除 此 之 外 ， 
编译 时 间 也 将 有 所 改善 。 
一 机 制 也 可 用 于 解决 其 他 Android 相关 问题 。 例 如 ， 当 向 Activity 传递 一 个 参数 时 。 
对 此 ， 标 准 的 Java 实现 方式 如 下 所 示 : 


// Java 
class SettingsActivity extends Activity ( 


























E 


final Doctor DOCTOR KEY - "doctorKey" 
final String TITLE KEY = "titleKey" 


Doctor doctor 
Address address 
String title 


public static void start ( Context context, Doctor doctor, 
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String title ) { 
Intent intent = new Intent(context, SettingsActivity.class ) 
intent.putExtra(DOCTOR KEY, doctor) 
intent.putExtra(TITLE KEY, title) 
context.startActivity (intent) 

} 

@override 

public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState) ; 
setContentView(R.layout.activity main); 


doctor = getExtras().getParcelable (DOCTOR KEY) 
title = getExtras().getString(TITLE KEY) 


ToastHelper.toast(this, doctor.id) 
ToastHelper.toast (this, title) 


H 
在 Kotlin 中 ， 可 采用 相同 的 实现 ， 但 也 可 随 变量 声明 获得 参数 值 (getString/getParcerable). 
对 此 ， 需 要 编写 下 列 扩展 函数 : 


fun «T : Parcelable» Activity.extra(key: String) = lazy 
( intent.extras.getParcelable«T» (key) ) 





fun Activity.extraString(key: String) - lazy 
( intent.extras.getString(key) } 


随后 ， 利 用 extra 和 extraString 委托 ， 可 获取 附加 参数 ， 如 下 所 示 : 


class SettingsActivity : Activity() { 


private val doctor by extra«Doctor» (DOCTOR KEY) // 1 
private val title by extraString(TITLE KEY) // 1 


override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate (savedInstanceState) 
setContentView(R.layout.settings activity) 
toast(doctor.id) // 2 
toast(title) // 2 


companion object { // 3 
const val DOCTOR KEY = "doctorKey" 
const val TITLE KEY = "titleKey" 
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fun 


) 
) 
} 
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start(context: Context, doctor: Doctor, title: String) ( // 3 


ontext.startActivity (getIntent«SettingsActivity» ().apply { 
putExtra (DOCTOR KEY, doctor) // 5 
putExtra(TITLE KEY, title) // 5 

}) 











// 4 


对 于 注释 1, 定义 了 属性 , 其 值 通过 对 应 键 从 Activity 参数 中 获取 ; 对 于 注释 2, TE onCreate 
方法 中 ,访问 源 自 参数 的 属性 。 当 请 求 属性 时 使 用 getter)， 延 迟 委 托 将 从 附加 项 中 获取 
参数 ， 并 对 其 存储 以 供 后 续 使 用 ， 对 于 注释 3， 定 义 了 一 个 静态 方法 启动 操作 ， 对 此 需要 


























使 用 伴生 对 象 ; 对 于 注释 4，SettingsActivity::class.java 表示 为 Java 类 引用 


注释 5， 使 用 











除 此 之 外 ， 还 可 
当 需 要 实现 快速 编译 时 ， 对 于 参数 注入 库 ， 例 如 











了 定义 于 第 7 章 中 的 相关 方法 。 








的 对 等 物 ， 对 于 


定义 函数 ， 并 获取 包 所 持 有 的 其 他 类 型 (例如 Long 和 Serializable). 
Il ActivityStarter， 这 可 视 作 是 一 种 较 好 的 替 


代 方 案 。 相 应 地 ， 可 使 用 类 似 的 函数 绑 定 字符 串 、 颜 色 、 服 务 、 资 源 库 以 及 模型 和 侵 辑 的 
其 他 部 分 ， 如 下 所 示 : 


fun <T> 


Activity.bindString(8IdRes id: Int): Lazy<T> = 


lazy ( getString(id) } 


fun «T» 


Activity.bindColour(GIdRes id: Int): Lazy<T> = 


lazy ( getColour(id) ) 

Activity 中 均 为 “重量 型 ”操作 ， 抑 或 取决 于 通过 延迟 委托 〈 或 异步 提供 的 ) 声明 的 
参数 。 另 外 , 还 应 将 所 有 元 素 ( 均 依 赖 于 须 延 迟 初 始 化 的 元 素 ) 均 定义 为 延迟 。 例 如 ,presenter 
定义 依赖 于 doctor 属性 ， 如 下 所 示 : 


val presenter by lazy { MainPresenter(this, doctor) } 














否则 ， 尝试 构造 MainPresenter 对 象 将 在 类 创建 时 进行 ， 此 时 无 法 读 取 数 据 值 ， 且 无 法 填充 
doctor 属性 ， 因 而 应 用 程序 将 崩溃 。 

上 述 示例 体现 了 Android 项 目 中 延迟 委托 的 有 效 性 ， 同 时 也 提供 了 较 好 的 属性 委托 ， 
使 代码 更 加 简单 和 优雅 。 

2. notNull 函数 


notNull 委托 可 视 作 一 类 最 为 简单 的 标准 库 委 托 , 因而 首先 对 其 加 以 讨论 , 其 应 








用 方式 
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如 下 所 示 : 
var someProperty: SomeType by notNull() 


提供 了 大 多 数 标准 库 委 托 ( 包括 notNull 函数 ) 的 函数 均 定义 于 object 
委托 中 。 当 对 此 加 以 使 用 时 ， 需 要 引用 该 对 象 ( Delegates.notNull() ) AAT 
以 导入 ( import kotlin. properties.Delegates.notNull ). 假设 在 当前 示例 中 ,obiect 
已 被 导入 ， 并 可 省 略 其 引用 操作 


notNull 委托 可 将 变量 定义 为 非 空 类 型 ， 并 在 稍 后 予以 初始 化 ， 而 非 在 对 象 的 构建 时 。 
此 处 ， 变 量 将 定义 为 非 空 类 型 ， 且 无 须 提供 默认 值 。notNull 函数 可 视 作 lateinit 的 一 种 蔡 
代 方 案 ， 如 下 所 示 : 


lateinit var someProperty: SomeType 


notNull 提供 了 与 lateinit 几乎 相同 的 效果 (除了 错误 消息 之 外 )。 当 在 首次 设 定 值 之 前 
使 用 该 属性 时 ， 将 抛 出 一 个 IllegalStateException 异常 ， 并 终止 Android 应 用 程序 。 因 此 ， 
仅 当 已 知晓 某 个 数值 在 首次 使 用 之 前 将 被 设置 时 方 可 对 其 加 以 使 用 。 

lateinit 和 notNull 委托 之 间 的 差异 也 较为 明显 。 其 中 ，lateinit {RF notNull 委托 ， 因 而 
应 尽量 优先 使 用 。 但 此 处 也 存在 一 些 限制 条 件 。 例 如 ，lateinit 无 法 用 于 基本 数据 ， 或 者 顶 
级 属性 。 因 而 ， 在 当前 示例 中 ， 将 采用 notNull。 

下 面 考察 notNull 委托 的 实现 过 程 ， 如 下 所 示 : 

public fun «T: Any» notNull(): ReadWriteProperty«Any?, T» = 

NotNullVar() 


不 难 发 现 ，notNull 实际 上 表示 为 返回 一 个 对 象 的 函数 ， 即 隐藏 于 ReadWriteProperty 接 
背后 的 实际 委托 实例 。 对 应 的 委托 定义 如 下 所 示 : 


private class NotNullVar«T: Any>() : ReadWriteProperty<Any?, T» ( // 1 
private var value: T? = null 

































































public override fun getValue(thisRef: Any?, 
property: KProperty<*>): T ( 
return value ?: throw IllegalStateException ("Property 
$(property.name) should be initialized before get.") // 2 
H 


public override fun setValue(thisRef: Any?, 

property: KProperty<*>, value: T) { 
this.value = value 

} 
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针对 注释 1， 类 定义 为 private， 一 种 可 能 的 原因 是 ， 该 类 通过 notNull 函数 提供 ， 并 将 其 返 
回 为 ReadWriteProperty<Any?, T>， 且 为 public 接口 ; 对 于 注释 2， 此 处 显示 了 返回 值 的 提 
供 方式 。 如 果 在 使 用 期 间 为 null， 该 值 不 会 被 设置 ， 且 对 应 方法 将 抛 出 一 个 错误 ， 和 否则 将 
返回 对 应 值 。 
上 述 委 托 机 制 易 于 理解 .setValue 函数 将 数值 设置 为 可 空 字段 , BAA null, 则 getValue 
返回 该 字段 ， 否 则 将 抛 出 异常 。 对 应 的 错误 示例 如 下 所 示 : 

var name: String by Delegates.notNull() 


println (name) 
// Error: Property name should be initialized before get. 


这 可 视 为 委托 属性 应 用 的 简单 示例 ， 同 时 也 较 好 地 介绍 了 属性 委托 的 工作 方式 。 委 托 属性 
是 一 种 强大 的 构造 机 制 ， 并 可 包含 多 个 应 用 程序 。 


3. observable 委托 
对 于 可 变 属性 , observable 是 一 类 功能 强大 的 标准 库 委托 。 每 次 设置 某 个 值 时 (set Value 
方法 将 被 调用 ), 源 自 声明 的 Lambda 函数 将 被 调用 。observable 委托 的 简单 示例 如 下 所 示 : 


var name: String by Delegates.observable ("Empty") { 
property, oldValue, newValue -> // 1 
println("$oldValue -> $newValue") // 2 



























































) 


// Usage 
name - "Martin" // 3, 
Prints: Empty -» Martin 
name - "Igor" // 3, 
Prints: Martin -> Igor 
name = "Igor" // 3, 4 
Prints: Igor -> Igor 
对 于 注释 1, Lambda 函数 参数 如 下 所 示 : 
e property 表示 委托 属性 的 引用 , 此 处 为 名 称 的 引用 , 等 同 于 源 自 setValue 和 getValue 
中 的 属性 并 表示 为 KProperty 类 型 。 在 当前 示例 (以 及 大 多 数 示例 ) 中 ， 若 未 加 使 
用 ， 则 可 设置 下 划 线 符号 。 
e oldValue 表示 property 的 上 一 个 值 〈 在 修改 前 )。 
e newValue 表示 property 的 新 值 〈 在 修改 后 )。 
对 于 注释 2， 在 每 次 将 新 值 设置 至 属性 中 时 ，Lambda 函数 将 被 调用 ;对 于 注释 3， 当 设置 
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新 值 时 ， 该 值 将 被 更 新 ， 但 同时 会 调用 声明 于 委托 中 的 Lambda 方法 ， 对 于 注释 4， 应 注 
意 每 次 使 用 setter 时 Lambda 将 被 调用 ， 新 旧 值 之 间 是 否 相 等 并 不 重要 。 

需要 特别 引起 重视 的 是 ，Lambda 在 每 次 设置 新 值 时 将 被 调用 ， 而 非 对 象 内 部 状态 改 
变 时 ， 如 下 所 示 : 

var list: MutableList<Int> by observable (mutableListof () ) 


{ , old, new -> 
println("List changed from $old to $new") 





) 


// Usage 

list.add(1) // 1 

list = mutableListoOf(2, 3) 

// 2, prints: List changed from [1] to [2, 3] 
针对 注释 1， 代 码 并 不 输出 任何 内 容 一 一 此 处 并 未 修改 属性 〈 未 使 用 setter)， 仅 调整 了 定 
义 于 列表 中 的 属性 ， 而 非 对 象 自身 ， 对 于 注释 2， 这 里 修改 了 列表 值 ， 因 而 调用 源 
observable 委托 的 Lambda 函数 ， 并 输出 文本 。 

observable 委托 对 于 不 可 变 类 型 来 说 十 分 有 用 ， 这 与 可 变 类 型 有 所 不 同 。Kotlin 中 全 
部 基本 类 型 默认 时 均 为 不 可 变 类 型 (List、Map、Set、Int、String)。 下 面 考察 Android 中 
的 实际 操作 示例 ， 如 下 所 示 : 


class SomeActivity : Activity() ( 
































var list: List«String» by Delegates.observable(emptyList()) ( 

prop, old, new -» if(old !- new) updateListView (new) 

me 

) 
每 次 修改 列表 时 ， 视 图 将 被 更 新 。 注 意 ， 若 List 不 可 变 ， 那 么 ， 在 进行 调整 时 则 需要 
使 用 到 setter， 从 而 可 确保 在 当前 操作 之 后 列表 将 得 到 更 新 。 与 每 次 列表 变化 时 调用 
updateListView 方法 相 比 ， 当 前 操作 则 更 加 简单 。 该 模式 可 广泛 地 应 用 于 项 目 中 ， 进 而 声 
明 编 辑 视图 的 属性 ， 这 将 改变 视图 更 新 机 制 的 工作 方式 。 

另 一 个 可 通过 observable 委托 处 理 的 问题 是 ， 在 ListAdapters 中 ， 每 次 列表 上 的 元 素 
变化 时 ，notifyDataSetChanged 将 被 调用 。 在 Java 中 ， 较 为 经 典 的 解决 方案 是 封装 该 列表 ， 
并 在 修改 该 列表 的 各 个 函数 中 调用 notifyDataSetChanged。 在 Kotlin 中 ， 可 通过 observable 
属性 委托 对 此 进行 简化 ， 如 下 所 示 : 
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var list: List«LocalDate» by observable(list) ( , old, new -> // 1 
if(new != old) notifyDataSetChanged() 

} 
对 于 注释 1， 需 要 注意 的 是 ， 此 处 的 列表 为 不 可 变 类 型 ， 因 此 ， 若 不 使 用 notifyDataSet 
Changed 方法 ， 则 无 法 修改 其 元 素 。 

observable 委托 用 于 定义 属性 值 变化 上 产生 的 行为 ， 常 用 于 属性 每 次 变化 时 应 执行 的 
操作 ; 或 者 需要 利用 某 个 视图 或 其 他 值 绑 定 属性 时 。 但 在 函数 内 部 ， 则 无 法 确定 新 值 是 否 
已 被 设置 。 对 此 ， 可 采用 vetoable 委托 。 


4. vetoable 委托 


vetoable 是 一 类 标准 库 属 性 委托 ， 其 工作 方式 与 observable 委托 类 似 ， 但 包含 两 点 主 
要 差异 ， 如 下 所 示 : 

e 参数 中 的 Lambda 在 新 值 被 设置 之 前 调用 。 

e 支 持 声明 中 的 Lambda 函数 ， 以 确定 新 值 是 否 应 被 接受 或 丢弃 。 

例如 ， 若 假设 列表 需要 包含 比 旧 值 多 的 数据 项 ， 则 需要 定义 下 列 vetoable 委托 : 

var list: List«String» by Delegates.vetoable (emptyList()) 


( , old, new => 
new.size » old.size 





























) 


如 果 情 况 相反 , 即 新 表 中 不 会 包含 比 旧 值 多 的 数据 项 , 则 对 应 值 不 会 发 生变 化 。 因 此 ， 
[将 vetoable 视 作 与 observable 类 似 ， 进 而 可 确定 该 值 是 否 可 被 修改 。 假 设 需要 一 个 与 视 
图 绑 定 的 列表 , 但 至 少 需要 3 个 元 素 。 此 处 不 允许 出 现任 何 变化 , 进而 可 包含 更 少 的 元 素 。 
对 应 实现 过 程 如 下 所 示 : 

var list: List«String» by Delegates.vetoable (emptyList () ) 
( prop, old, new -> 
if(new.size < 3) return@vetoable false // 1 


updateListView (new) 
true // 2 


al 

















} 


对 于 注释 1, 新 表 的 尺寸 小 于 3, 因而 不 予 接受 并 从 Lambda 中 返回 false. 包含 标记 的 return 
语句 返回 的 false (E HFA Lambda 表达 式 中 返回 ) 体现 了 一 类 信息 ， 表 示 新 值 不 应 予以 
接受 。 

对 于 注释 2, Lambda 函数 需要 返回 一 个 值 ， 该 值 源 自 包 含 标记 的 retum, 或 者 Lambda 
体 的 最 后 一 行 。 这 里 ， 值 true 表示 新 值 应 予以 接受 。 
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对 应 的 应 用 示例 如 下 所 示 : 


listVetoable = listOf("A", "B", "C") // Update A, B, C 
println(listVetoable) // Prints: [A, B, C] 
listVetoable = listof("A") // Nothing happens 
println(listVetoable) // Prints: [A, B, C] 
listVetoable = listOf("A", "B", "C", "D", "E") 

Ji Prints: M, B: C D,- EJ 








除 此 之 外 ,还 可 使 其 不 发 生 任何 变化 ， 其 中 涉及 某 些 其 他 原因 , 例如 仍 在 加 载 数据 。 另外， 











vetoable 属性 委托 也 可 用 于 验证 器 中 ， 如 下 所 示 ; 


var name: String by Delegates.vetoable("")( prop, old, new -> 
if (isValid(new)) { 
showNewData (new) 
true 
) else ( 
showNameError () 
false 


) 
此 属性 仅 可 根据 断言 isValid(new) 更 改 为 正确 的 值 。 


5. 属性 委托 至 Map 类 型 


针对 包含 String 键 类 型 的 Map 和 MutableMap， 标 准 库 包 含 了 相应 的 扩展 ， 进 而 提供 


了 getValue 和 setValue HA. Hilt, map 也 可 用 作 属 性 委托 ， 如 下 所 示 : 


class User (map: Map<String, Any») { // 1 
val name: String by map 
val kotlinProgrammer: Boolean by map 
) 


// Usage 
val map: Map<String, Any» = mapOf( // 2 
"name" to "Marcin", 
"kotlinProgrammer" to true 
) 
val user - User(map) // 3 
printin(user.name) // Prints: Marcin 
println(user.kotlinProgrammer) // Prints: true 


对 于 注释 1, Map 键 类 型 须 为 Sting， 而 值 类 型 则 并 无 限制 ， 通 常 为 Any 或 Any?; 对 于 注 
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TE 2， 将 创建 包含 全 部 值 的 Map; 对 于 注释 3， 将 向 某 个 对 象 提供 一 个 map。 
对 于 在 Map 中 持 有 数据 ， 这 将 十 分 有 用 。 除 此 之 外 ， 还 将 涉及 以 下 原因 : 
e 当 希 望 简化 此 类 数据 的 访问 时 。 
o 当 定 义 一 个 结构 ， 并 通知 我 们 在 当前 Map 中 应 接受 何 种 类 型 的 键 。 
e 当 请 求 一 个 委托 至 Map 中 的 属性 时 ， 针 对 等 同 于 属性 名 的 键 ， 对 应 值 将 源 自 当 
Map. 
具体 实现 过 程 如 何 表示 ? 下 列 内 容 源 自 标准 库 中 的 一 段 简化 代码 : 


operator fun «V, Vl: V» Map<String, V>.getValue( // 1 
thisRef: Any?, // 2 
property: KProperty<*>): V1 ( // 3 
val key - property.name // 4 
val value - get (key) 
if (value == null && !containsKey(key)) { 
throw NoSuchElementException ("Key ${property.name} 
is missing in the map.") 
) else ( 
return value as V1 // 3 














lik 
= 











} 

} 
对 于 注释 1，V 表示 为 列表 上 的 值 类 型 ， 对 于 注释 2，thisRef 表示 为 Any? 类 型 。 因 此 ， 
Map 可 用 作 任 意 上 下 文中 的 属性 委托 ; 对 于 注释 3，V1 表示 为 返回 类 型 ， 并 根据 属性 进行 
推断 ， 但 须 为 V 类 型 的 子 类 型 ， 对 于 注释 4， 属 性 名 用 作 map 上 的 键 。 

需要 记 住 的 是 ， 这 仅 为 一 个 扩展 函数 。 对 象 表示 为 一 个 委托 所 需 的 全 部 工作 则 是 涵盖 
一 个 getValue 方法 (以 及 针对 读 - 写 属性 的 setValue 方法 )。 通 过 对 象 声 明 ， 甚 至 可 从 一 个 
匿名 类 对 象 中 创建 一 个 委托 ， 如 下 所 示 : 


val someProperty by object ( // 1 
operator fun getValue(thisRef: Any?, 
property: KProperty<*>) = "Something" 
} 
println(someProperty) // prints: Something 
对 于 注释 1, object 未 实现 为 接口 ， 仅 包含 了 一 个 基于 适当 签名 的 getValue 方法 。 这 已 然 
可 令 其 像 只 读 属 性 委托 那样 工作 。 
注意 ,在 map 中 ， 当 请 求 属性 值 时 ， 须 存在 一 个 包含 此 类 名 称 的 入 口 项 ， 否 则 将 抛 出 
一 个 错误 〈 令 属性 为 可 空 类 型 仍 无 法 改变 这 一 状况 )。 
map 的 委托 字段 十 分 有 用 。 例 如， 当 从 包含 动态 字段 的 API 中 获取 一 个 对 象 时 。 对 此 ， 
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将 所 提供 的 数据 视 为 一 个 对 象 ， 进 而 可 方便 地 访问 其 字段 ; 另外 ， 还 须 将 其 作为 map, 
并 列 出 API 所 提供 的 全 部 字段 (甚至 可 能 会 包含 某 些 非 期 望 字段 )。 











上 述 示例 使 用 了 Map 且 为 不 可 变 类 型 。 因此， 对 象 属性 为 只 读 val)。 如 果 需 要 令 对 














象 为 可 变 类 型 ， 则 应 使 用 MutableMap; 随后 ， 该 属性 可 定义 为 可 变 类 型 (val)。 对 应 示例 
下 所 示 : 








class User(val map: MutableMap<String, Any») { 
var name: String by map 
var kotlinProgrammer: Boolean by map 
override fun toString(): String - "Name: $name, 
Kotlin programmer: $kotlinProgrammer" 
} 


// Usage 
val map = mutableMapof( // 1 
"name" to "Marcin", 
"kotlinProgrammer" to true 
) 
val user - User (map) 
println(user) // prints: Name: Marcin, Kotlin programmer: true 
user.map.put("name", "Igor") // 1 
println(user) // prints: Name: Igor, Kotlin programmer: true 
user.name = "Michal" // 2 
println(user) // prints: Name: Michal, Kotlin programmer: true 


对 于 注释 1， 属 性 值 可 通过 调整 map 值 进行 修改 ， 对 于 注释 2， 属 性 值 还 可 像 其 他 属性 那 
样 被 修改 。 实 际 上 ， 对 应 值 变 化 委托 至 setValue， 进 而 修改 map。 





尽管 这 里 的 属性 为 可 变 类 型 ,但 仍 须 提供 setValue 函数 。 对 于 MutableMap， 可 实现 为 





扩展 函数 ， 其 简化 代码 如 下 所 示 : 





operator fun «V» MutableMap<String, V».setValue( 
thisRef: Any?, 
property: KProperty<*>, 
value: V 
yi 
put (property.name, value) 
} 


需要 注意 的 是 ， 即 使 是 如 此 简单 的 函数 ， 也 可 采取 这 样 的 创新 方式 使 用 公共 对 象 。 
Kotlin 支持 自 定义 委托 。 对 此 , 存在 多 个 库 提 供 了 新 的 属性 委托 机 制 ， 并 可 在 Android 






































于 不 同 的 功能 ; 另外 ， 在 Android 中 ， 属 性 委托 应 用 方式 也 多 种 多 样 。 下 面 将 对 相关 
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示例 加 以 考察 ， 读 者 将 会 从 中 发 现 该 特征 的 有 效 性 。 
8.23 BEBE 


之 前 讨论 的 全 部 委托 均 来 自 标准 库 ， 但 读者 也 可 轻松 地 实现 自己 的 属性 委托 。 如 前 
述 ， 若 将 某 个 类 设置 为 委托 ， 需 要 提供 getValue 和 setValue 函数 ， 且 需要 包含 实际 签名 ， 

















但 无 须 对 类 进行 扩展 或 实现 接口 。 当 对 象 用 作 委托 时 ， 并 不 需要 调整 其 内 部 实现 ， 其 原 
在 于 ， 可 将 getValue 和 setValue 定义 为 扩展 函数 。 然 而 ， 若 创建 自 定 义 类 以 作为 委托 时 ， 
接口 机 制 可 能 十 分 有 用 ， 原 因 如 下 : 

e 将 定义 函数 结构 ， 因 而 可 在 Android Studio 中 生成 相应 的 方法 。 

o 若 正在 创建 库 ， 则 须 将 委托 类 指定 为 私有 或 内 部 类 ， 以 防止 外 界 的 误 操作 。 该 情形 









































曾 出 现 于 notNull 部 分 中 ， 其 中 ， 类 NotNullVar 定义 为 私有 类 ， 并 用 作 Read 





WriteProperty<Any?, > 接口 。 
提供 了 全 功能 以 支持 委托 类 的 接口 分 别 为 ReadOnlyProperty (针对 只 读 属 性 ) 和 
ReadWriteProperty (针对 读 写 属性 )， 二 者 十 分 有 用 ， 其 定义 如 下 所 示 : 
public interface ReadOnlyProperty<in R, out T> { 
public operator fun getValue(thisRef: R, 
property: KProperty<*>): T 
) 


public interface ReadWriteProperty<in R, T» { 
public operator fun getValue(thisRef: R, 
property: KProperty<*>): T 
public operator fun setValue(thisRef: R, 
property: KProperty<*>, value: T) 
} 
其 中 ， 参 数值 之 前 已 有 所 讨论 ， 下 面 再 次 对 其 进行 回顾 ， 其 中 包括 : 
e thisRef 表示 对 象 的 引用 ， 其 中 使 用 了 委托 ， 其 类 型 定义 了 所 用 委托 的 上 下 文 。 
e property 表示 为 引用 ， 包 含 了 与 委托 属性 相关 的 数据 ， 也 就 是 说 ， 与 对 应 属性 相关 
的 全 部 信息 ， 例 如 名 称 和 类 型 。 
e value 表示 为 设置 的 新 值 。 


thisRef 和 property 参数 并 未 使 用 下 列 委 托 :Lazy、Observable 和 Vetoable.. 
qp Map, MutableMap 和 notNull 则 使 用 了 属性 ， 获 取 针 对 键 的 属性 名 。 但 这 一 
类 参数 可 用 于 不 同 的 场合 。 
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下 面 考 察 一 些 简单 有 效 的 自 定义 属性 委托 示例 ， 之 前 曾 探讨 了 针对 只 读 属 性 的 延迟 属 
性 委托 。 然 而 ， 某 些 时 候 ， 还 需要 使 用 到 可 变 的 延迟 属性 。 如 果 和 希望 在 初始 化 之 前 请 求 该 
值 ， 则 应 从 初始 器 指定 该 值 并 返回 该 值 。 在 其 他 场合 下 ， 还 可 用 作 常 规 的 可 变 属性 ， 如 下 
所 示 : 


fun <T> mutableLazy (initializer: () -> T): ReadWriteProperty<Any?, T> = 
MutableLazy<T> (initializer) 






































private class MutableLazy<T>(val initializer: () -> T) : 
ReadWriteProperty«Any?, T» ( 


private var value: T? - null 
private var initialized - false 


override fun getValue(thisRef: Any?, property: KProperty<*>): T ( 
synchronized(this) ( 
if (!initialized) { 
value = initializer () 
} 
return value as T 


} 


override fun setValue(thisRef: Any?, 
property: KProperty<*>, value: T) { 
synchronized(this) { 
this.value = value 
initialized = true 


5 

对 于 注释 1， 委 托 隐藏 于 接口 之 后 并 通过 函数 提供 服务 ， 因 此 ， 可 调整 MutableLazy 
的 实现 ， 且 无 须 担 心 是 否 会 影响 到 对 其 加 以 使 用 的 代码 。 
在 注释 2 中 ， 实 现 了 ReadWriteProperty。 虽 然 这 是 一 个 可 选项 ， 但 却 十 分 有 用 一 一 此 
处 定义 了 读 写 属 性 的 正确 结构 。 其 中 ， 第 一 种 类 型 为 Any?， 表 示 可 在 任意 环境 下 使 用 该 
属性 委托 ， 第 二 种 类 型 则 为 泛 型 。 注 意 ， 关 于 该 类 型 ， 并 不 存在 限制 条 件 ， 因 而 可 以 是 可 

针对 注释 3， 属 性 值 存储 于 value 属性 中 ， 并 通过 初始 化 后 的 属性 体现 。 采 用 该 方式 
的 原因 在 于 ， 支 持 了 为 可 空 类 型 。 随 后 ， 该 值 中 的 null 表示 尚未 初始 化 ， 或 者 等 于 null. 
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对 于 注释 4， 无 须 使 用 operator 修饰 符 却 已 经 用 于 接口 中 。 

对 于 注释 5，getValue 在 设置 任意 值 之 前 被 调用 ， 随 后 ， 该 值 通过 初始 化 器 进行 设置 ; 
对 于 注释 6， 需 要 将 当前 值 转换 为 T 一 该 值 可 能 为 非 空 ， 同 时 可 利用 null 作为 初始 值 ， 进 
而 将 该 值 初始 化 为 可 空 类 型 。 
在 Android 开发 中 ， 上 述 属性 委托 在 不 同 场合 下 十 分 有 用 。 例 如 ， 当 属性 的 默认 值 存 
储 于 某 个 文件 中 ， 且 需要 对 其 进行 读 取 时 (这 将 是 一 项 繁重 的 操作 )， 如 下 所 示 : 

Var gameMode : GameMode by MutableLazy { 


getDefaultGameMode () 
} 























var mapConfiguration : MapConfiguration by MutableLazy { 
getSavedMapConfiguration() 
) 


var screenResolution : ScreenResolution by MutableLazy { 
getOptimalScreenResolutionForDevice () 
} 
当 采 用 上 述 方式 时 ， 如 果 用 户 在 应 用 之 前 设置 该 属性 的 自 定义 值 ， 则 无 须 亲 自 对 其 进行 计 
算 。 另 外 ， 第 二 个 自 定义 属性 委托 则 可 定义 属性 getter， 如 下 所 示 : 
val a: Int get() = 1 
val b: String get() - "KOKO" 
val c: Int get() = 1 + 100 
在 Kotlin 1.1 之 前 ， 通 常 需要 定义 属性 类 型 。 为 了 避免 这 一 行为 ， 可 定义 下 列 函 数 类 
型 的 扩展 函数 〈 因 而 还 涉及 Lambda 表达 式 )， 如 下 所 示 : 
inline operator fun <R> (() -> R).getValue( 
thisRef: Any?, 


property: KProperty<*> 
): R = invoke() 


随后 可 采用 类 似 的 方式 定义 属性 ， 如 下 所 示 : 


val a by { 1 } 
val b by { "KOKO" } 
val c by { 1 + 100 } 


上 述 方式 会 导致 性 能 降低 ， 因 而 这 里 不 建议 使 用 ， 但 这 也 体现 了 委托 属性 的 一 种 
可 能 性 。 这 一 类 小 型 扩展 函数 使 得 函数 类 型 转 为 属性 委托 ， 并 在 编译 后 生成 了 更 加 简单 的 
Kotlin 代码 〈 注 意 ， 扩 展 函 数 标记 为 inline， 因 而 其 调用 通过 函数 体 蔡 换 )， 如 下 所 示 : 
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private val ^a$delegate" = { 1 } 

val a: Int get() = "a$delegate' () 
private val `b$delegate = { "KOKO" } 
val b: String get() = "b$delegate' () 
private val `c$delegate = { 1 + 100 } 
val c: Int get() = "c$delegate' () 


下 面 将 考察 实际 项 目 中 的 某 些 自 定义 委托 ， 该 机 制 将 随 着 具体 问题 一 同 被 提出 。 
1. 视图 绑 定 
当 在 项 目 中 采用 模型 -视图 -表示 器 (MVP) 时 ， 需 要 通过 表示 器 在 视图 中 进行 全 部 修 


























改 。 因 此 ， 可 在 视图 上 强制 创建 多 个 函数 ， 如 下 所 示 





override fun getName(): String { 
return nameView.text.toString() 
) 


override fun setName (name: String) { 
nameView.text = name 
) 


另外 ， 还 可 在 下 列 接口 中 定义 函数 : 


interface MainView ( 
fun getName(): String 
fun setName (name: String) 
} 


通过 属性 绑 定 机 制 ， 可 简化 前 述 代码 ， 并 减少 setter/getter 方法 的 需求 。 对 此 ， 可 针对 








元 素 绑 定 对 应 属性 ， 如 下 所 示 : 





override var name: String by bindToTex(R.id.textView) 











对 应 接口 如 下 所 示 : 








interface MainView ( 
var name: String 








) 
上 述 代码 更 加 简洁 且 易于 维护 。 注意， 此 处 通过 参数 提供 了 元 素 ID。 下 列 代码 实现 了 一 个 
简单 的 类 : 





fun Activity.bindToText ( 
@IdRes viewId: Int ) = object : 
ReadWriteProperty«Any?, String» ( 
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val textView by lazy ( findViewById«TextView» (vi 


override fun getValue(thisRef: Any?, 
property: KProperty<*>): String { 
return textView.text.toString() 

} 


override fun setValue(thisRef: Any?, 
property: KProperty<*>, value: String) { 
textView.text = value 


} 
针对 不 同 的 视图 属性 以 及 不 同 的 上 下 文 (Fragment, Service) 





ewId) } 


> 可 创建 类 似 的 绑 定 机 制 。 


另 一 个 较为 有 效 的 工具 是 可 见 性 的 绑 定 , 也 就 是 说 , 将 某 个 逻辑 属性 (对 应 类 型 为 Boolean) 


绑 定 至 view 元 素 的 可 见 性 上 ， 如 下 所 示 : 


fun Activity.bindToVisibility( 
@IdRes viewId: Int ) = object : 
ReadWriteProperty«Any?, Boolean» ( 


val view by lazy ( findViewById(viewId) } 


override fun getValue(thisRef: Any?, 
property: KProperty<*>): Boolean ( 
return view.visibility == View.VISIBLE 
) 


override fun setValue(thisRef: Any?, 
property: KProperty<*>, value: Boolean) { 


view.visibility = if(value) View.VISIBLE else View.GONE 


) 


上 述 实 现在 Java 中 难以 完成 。 类 似 的 绑 定 行为 还 可 针对 其 他 Vi 
基础 上 可 实现 简单 、 明 了 的 操作 过 程 。 上 述 代码 片段 仅 为 一 个 简 











ew 元 素 创建 ， 在 MVP 的 
示例 , 读者 可 访问 Kotlin- 





AndroidViewBindings 库 , 并 查看 更 多 的 实现 方案 (对 应 网 址 为 https://github.com/ MarcinMoskala/ 


KotlinAndroidViewBindings )。 


2. 优先 绑 定 





二 于 更 复杂 的 示例 ， 可 在 SharedPreferences 的 帮助 下 予以 实现 。 针 对 这 一 问题 ,Kotlin 提 











供 了 更 好 的 解决 方法 。 最 终 ， 可 将 保存 于 SharedPreferences 中 的 数值 视 作 Shared Preferences 
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对 象 的 属性 。 具 体 应 用 如 下 所 示 : 


preferences.canEatPie = true 

if(preferences.canEatPie) ( 
// Code 

} 


下 列 代码 显示 了 扩展 属性 定义 : 


var SharedPreferences.canEatPie: 

Boolean by bindToPreferenceField(true) // 1 

var SharedPreferences.allPieInTheWorld: 

Long by bindToPreferenceField(0,"AllPieKey") //2 


对 于 注释 1， 表 示 为 类 型 Boolean 属性 。 若 某 个 属性 非 空 ， 则 需要 在 函数 的 第 一 个 参数 中 
提供 默认 值 。 对 于 注释 2， 属 性 可 包含 所 提供 的 自 定义 键 ， 这 在 实际 项 目 中 十 分 有 用 ， 进 
而 可 对 该 键 进行 操控 〈 例 如， 在 属性 重 命名 时 防止 意外 修改 )。 
下 面 通过 深入 研究 非 空 属 性 以 了 解 优先 绑 定 的 工作 方式 。 对 此 , 首先 分 析 提 供 方 函数 。 
需要 注意 的 是 ， 属 性 类 型 由 数值 与 SharedPreferences 间 的 获取 方式 确定 〈 由 于 存在 不 同 的 
函数 ， 例 如 getString. getint 等 )， 因 而 所 需 类 的 类 型 应 作为 内 联 函数 的 reified 类 型 ,或 者 
通过 当前 参数 这 一 方式 予以 提供 。 对 应 的 委托 提供 方 函数 如 下 所 示 : 


inline fun «reified T : Any» bindToPreferenceField( 
default: T?, 


key: String? - null 
): ReadWriteProperty«SharedPreferences, T» // 1 
7 bindToPreferenceField(T::class, default, key) 





















































fun «T : Any» bindToPreferenceField( // 2 
clazz: KClass<T>, 
default: T?, 
key: String? - null 
): ReadWriteProperty<SharedPreferences, T> 
= PreferenceFieldBinder(clazz, default, key) // 1 














对 于 注释 1， 两 个 函数 均 返 回 基于 ReadWriteProperty<SharedPreferences, T> 接 口 的 对 象 。 
注意 ， 此 处 的 上 下 文 被 设置 为 SharedPreferences， 因 而 仅 可 于 此 处 或 SharedPreferences 扩 
内 使 用 。 之 所 以 定义 该 函数 ， 其 原因 在 于 : 参数 类 型 无 法 被 重 定 义 ， 且 需要 作为 常规 参 
数 提供 类 型 。 对 于 注释 2，bindToPreferenceField 函数 不 可 定义 为 private 或 internal, AL 
内 联 函 数 仅 可 使 用 包含 相同 或 较 少 限制 的 修饰 符 的 函数 。 

最 后 考察 委托 类 PreferenceFieldDelegate， 如 下 所 示 : 
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internal open class PreferenceFieldDelegate<T : Any>( 
private val clazz: KClass<T>, 
private val default: T?, 
private val key: String? 

) : ReadWriteProperty<SharedPreferences, T> { 


override operator fun getValue(thisRef: SharedPreferences, 
property: KProperty<*>): T 
= thisRef.getLong(getValue<T>(clazz, default, getKey(property) ) 


override fun setValue(thisRef: SharedPreferences, 
property: KProperty<*>, value: T) { 
thisRef.edit().apply 
( putValue(clazz, value, getKey(property)) }-apply() 


private fun getKey(property: KProperty<*>) = 
key ?: "${property.name}Key" 
} 


目前 ,我 们 已 了 解 了 thisRef 的 使 用 方式 ， 其 类 型 为 SharedPreferences， 并 可 以 此 获取 
或 设置 全 部 值 。 取 决 于 属性 类 型 ， 用 于 获取 和 保存 数值 的 函数 定义 如 下 所 示 : 


internal fun SharedPreferences.Editor.putValue(clazz: KClass«*», value: 
Any, key: String) ( 
when (clazz.simpleName) ( 
"Long" -> putLong(key, value as Long) 
"Int" -> putInt(key, value as Int) 
"String" -» putString(key, value as String?) 
"Boolean" -> putBoolean(key, value as Boolean) 
"Float" -> putFloat(key, value as Float) 
else -» putString(key, value.toJson()) 


internal fun «T: Any» SharedPreferences.getValue (clazz: KClass<*>, default: 
T?, key: String): T - when (clazz.simpleName) ( 

"Long" -> getLong(key, default as Long) 

"Int" -> getInt(key, default as Int) 

"String" -» getString(key, default as? String) 

"Boolean" -> getBoolean(key, default as Boolean) 

"Float" -> getFloat(key, default as Float) 

else -> getString(key, default?.toJson()).fromJson(clazz) 
$ oos T 
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除 此 之 外 ， 还 须 定 义 toJson 和 fromJson， 如 下 所 示 : 


Var preferencesGson: Gson = GsonBuilder ().create() 
internal fun Any.toJson() = preferencesGson.toJson (this) !! 
internal fun «T : Any» String.fromJson(clazz: KClass<T>) = 
preferencesGson.fromJson(this, clazz.java) 


根据 上 述 定义 ， 可 将 附加 扩展 属性 定义 至 SharedPreferences， 如 下 所 示 : 
var SharedPreferences.canEatPie: Boolean by bindToPreferenceField (true) 


在 第 7 章 中 曾 讨论 到 ，Java 中 并 不 存在 此 类 字段 可 添加 至 类 中 。 实 际 上 ， 扩 展 属性 将 
编译 为 getter 和 setter 函数 ， 并 将 调用 委托 至 所 创建 的 委托 中 ， 如 下 所 示 : 


val 'canEatPie$delegate' = bindToPreferenceField(Boolean::class, true) 











fun SharedPreferences.getCanEatPie(): Boolean ( 
return 'canEatPie$delegate'.getValue (this, 
SharedPreferences::canEatPie) 

) 


fun SharedPreferences.setCanEatPie(value: Boolean) ( 
'canEatPie$delegate'.setValue(this, SharedPreferences::canEatPie, 
value) 

) 


另外 ， 扩 展 函 数 实际 上 表示 为 在 第 一 个 参数 上 包含 扩展 的 静态 函数 ， 如 下 所 示 : 


val 'canEatPie$delegate' = bindToPreferenceField(Boolean::class, true) 


fun getCanEatPie (receiver: SharedPreferences): Boolean { 
return 'canEatPie$delegate'.getValue (receiver, 
SharedPreferences::canEatPie) 

} 


fun setCanEatPie(receiver: SharedPreferences, value: Boolean) ( 
'canEatPie$delegate'.setValue (receiver, 
SharedPreferences::canEatPie, value) 

) 

前 述 示例 足以 说 明 属性 委托 的 工作 方式 以 及 使 用 方式 。 属 性 委托 广泛 地 应 用 于 Kotlin 
开源 项 目 中 ， 可 加 速 并 简化 依赖 注入 (Dependency Injection， 例 如 Kodein, Injekt 和 
TornadoFX)、 视 图 绑 定 、SharedPreferences 或 其 他 元 素 (已 知 内 容 包 括 PreferenceHolder 
All KotlinAndroidViewBindings) 的 实现 ， 进 而 设置 配置 定义 上 的 属性 键 ， 例 如 Konfig， 或 
者 定义 数据 库 列 结构 , 例如 Kwery。 除 此 之 外 ,还 存在 更 为 广阔 的 应 用 领域 等 待 读者 发 现 。 
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3. 提供 委托 


自 版 本 1.1 之 后 ，Kotlin 提供 了 provideDelegate 操作 符 ， 并 可 在 类 初始 化 过 程 中 提供 
委托 。provideDelegate 背后 的 含义 是 ， 可 根据 属性 特性 〈 例 如 名 称 、 类 型 以 及 注解 等 ) 提 
供 自 定义 委托 。 

provideDelegate 操作 符 返 
例如 下 所 示 : 


class A(val i: Int) { 











n 


委托 ， 包 含 该 操作 符 的 全 部 类 型 自身 无 须 为 委托 ， 对 应 示 














operator fun provideDelegate( 
thisRef: Any?, 
prop: KProperty<*> 
) = object: ReadOnlyProperty«Any?, Int» { 


override fun getValue( 
thisRef: Any?, 
property: KProperty<*> 
ph 


) 


val a by A(1) 


在 该 示例 中 ，A 用 作 委托 ， 但 并 未 实现 为 getValue 或 setValue 函数 ， 其 原因 在 于 ， 此 处 定 
义 了 provideDelegate 操作 符 ， 并 返回 所 用 的 委托 ， 而 非 A。 相 应 地 ， 属 性 委托 将 编译 为 下 
列 代码 : 

private val a$delegate = A().provideDelegate(this, this::prop) 

val a: Int 

get() = al$delegate.getValue(this, this::prop) 
具体 应 用 则 位 于 Kotlin 的 ActivityStarter 库 中 (对 应 网 址 为 https://github. com/ Marcin 
Moskala/ActivityStarter) . 其 中 , 操作 参数 通过 注解 加 以 定义 , 但 可 采用 属性 委托 简化 Kotlin 
应 用 ， 并 支持 属性 定义 为 只 读 或 非 lateinit， 如 下 所 示 : 

@get:Arg (optional = true) val name: String by argExtra (defaultName) 

Gget:Arg(optional = true) val id: Int by argExtra (defaultId) 


@get:Arg val grade: Char by argExtra() 
@get:Arg val passing: Boolean by argExtra() 


当然 ， 一 些 限 制 条 件 依然 不 可 或 缺 ， 其 中 包括 : 
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e 当 使 用 argExtra 时 ， 须 注解 属性 getter. 

e 若 参 数 可 选 ， 且 类 型 不 可 空 ， 则 须 指定 默认 值 。 

当 检 测 此 类 需求 条 件 时 ， 须 引用 属性 以 获取 getter 注解 。 在 argExtra 函数 中 ， 则 无 
包含 此 类 引用 ， 但 可 将 其 实现 于 provideDelegate P, W FAR: 


fun «T» Activity.argExtra(default: T? = null) - 

ArgValueDelegateProvider (default) 

fun <T> Fragment.argExtra (default: T? mr 

ArgValueDelegateProvider (default) 

fun «T» android.support.v4.app.Fragment.argExtra (default: T? = null) = 
ValueDelegateProvider (default) 






































class ArgValueDelegateProvider«T» (val default: T? = null) ( 
operator fun provideDelegate( 
thisRef: Any?, 
prop: KProperty<*> 
): ReadWriteProperty«Any, T» ( 
val annotation = prop.getter.findAnnotation«Arg» () 
when ( 
annotation == null -> 
throw Error (ErrorMessages.noAnnotation) 
annotation.optional && !prop.returnType.isMarkedNullable && 
default -- null -» 
throw Error (ErrorMessages.optionalValueNeeded) 
} 
return ArgValueDelegate (default) 


internal object ErrorMessages { 
const val noAnnotation = 
"Element getter must be annotated with Arg" 
const val optionalValueNeeded = 
"Arguments that are optional and have notnullabletype must have defaut 
value specified" 
l 


若 条 件 未 被 满足 ， 此 类 委托 将 抛 出 相应 的 错误 ， 如 下 所 示 : 


val a: A? by ArgValueDelegateProvider () 
// Throws error during initialization: Element getter must be 
// annotated with Arg 
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@get:Arg (optional = true) val a: A by ArgValueDelegateProvider () 
//throws error during initialization: Arguments that are optional 
//and have not-nullable type must have default value specified. 


通过 这 一 方式 ， 不 被 接受 的 参数 定义 将 在 对 象 初始 化 过 程 中 抛 出 相应 的 错误 ， 而 不 是 
以 非 确 定 方式 中 断 应 用 程序 。 
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本 章 讨 论 了 类 委托 、 属 性 委托 及 其 应 用 方式 ， 进 而 消除 元 余 代码 。 其 中 ， 可 将 委托 定 
义 为 一 个 对 象 ， 并 从 所 委托 的 其 他 对 象 或 属性 中 调用 。 此 过 程 中 还 涉及 设计 模式 内 容 ， 与 
类 委托 关系 紧密 的 设计 模式 包括 委托 设计 模式 和 装饰 器 设计 模式 。 

如 前 所 述 ， 委 托 模式 可 视 作 继承 的 替代 方案 ， 而 装饰 器 模式 则 可 向 实现 了 同一 接口 的 
不 同类 添加 功能 项 。 本 章 介绍 了 属性 委托 的 工作 方式 ， 以 及 Kotlin 标准 库 属 性 委托 ， 包 括 
notNull, lazy. observable, vetoable, Map 及 其 应 用 方式 。 此 外 ， 本 章 还 探讨 了 自 定义 属 
性 委托 的 生成 方式 以 及 应 用 示例 。 

需要 注意 的 是 ， 除 了 理解 不 同 特性 及 其 应 用 之 外 ， 读 者 还 须 明晰 其 整合 方式 ， 进 而 
构建 大 型 应 用 程序 。 第 9 章 将 编写 一 个 示例 应 用 程序 ， 并 解释 各 种 Kotlin 特性 之 间 的 整 
合 方式 。 
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前 述 章节 讨论 了 Kotlin 中 的 大 部 分 重要 特性 ， 进 而 简化 Android 开发 并 提升 效率 。 但 
相关 内 容 稍 显 零散 ， 因 而 读者 难以 理解 整体 项 目的 实现 过 程 。 因 此 ， 本 章 将 利用 Kotlin 语 
言 编写 一 个 项 目 应 用 程序 。 

这 里 的 问题 是 ， 究 竟 选 择 哪 一 种 应 用 程序 予以 实现 ? 该 程序 应 具备 短小 、 简 单 等 
特征 ， 同 时 还 应 兼顾 大 多 数 Kotlin 特性 。 除 此 之 外 ， 还 应 减少 库 的 使 用 量 一 一 本 书 集 
中 讨论 Kotlin 中 的 Android 开发 ， 而 非 Android 库 。 同 时 ， 应 用 程序 应 避免 采用 手动 方 
式 实现 图 像 元素 ， 该 过 程 通常 较为 复杂 ， 从 Kotlin 角度 来 看 ， 这 并 未 获得 应 有 的 收益 。 

最 终 ， 本 章 将 尝试 编写 一 个 Marvel Gallery 应 用 程序 ， 该 App 可 用 于 搜索 我 们 喜爱 的 
漫 威 漫画 角色 ， 并 显示 其 详细 内 容 。 其 中 ， 全 部 数据 均 由 Marvel 网 站 并 通过 其 API 提供 。 





















































9.1 Marvel Gallery 应 用 程序 


Marvel Gallery 应 用 程序 须 涵盖 下 列 用 例 : 

e 在 启动 应 用 程序 后 ， 用 户 应 可 看 到 角色 图 片 库 。 

e 在 启动 应 用 程序 后 ， 用 户 可 通过 名 称 搜索 角色 。 

e 当 用 户 单 击 角 色 图 像 时 ， 应 显示 资料 信息 ， 其 中 包含 角色 名 称 、 照 片 、 描 述 以 及 访 

问 数 量 。 

相应 地 ， 存 在 3 个 用 例 可 描述 应 用 程序 的 主 功能 项 ， 稍 后 将 对 此 逐一 予以 实现 。 完 
整 的 应 用 程序 内 容 位 于 GitHub E, 对 应 网 址 为 https://github.com/MarcinMoskala/Marvel 
Gallery。 

为 了 初步 理解 构建 内 容 ， 图 9.1 显示 了 应 用 程序 最 终 版 本 的 截图 。 


9.1.1 ”如 何 阅读 本 章 内 容 


本 章 展示 了 构建 应 用 程序 所 需 的 全 部 步骤 和 代码 ， 以 及 应 用 程序 开发 过 程 中 的 各 项 步 
又 。 在 此 过 程 中 ， 读 者 应 关注 开发 流程 ， 并 理解 代码 功能 。 相 应 地 ， 读 者 无 须 理解 相关 布 
局 以 及 单元 测试 的 定义 。 对 此 ， 读 者 仅 须 了 解 其 功能 即 可 。 另 外 ， 强 调 应 用 程序 结构 以 及 
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Marvel Gallery Marvel Gallery 





Search for character 


Wolverine 








Bom with super-human senses 
and the power to heal from 
almost any wound, Wolverine was 
captured by a secret Canadian 
organization and given an 
unbreakable skeleton and claws. 
Treated like an animal, it took 
years for him to control himself. 
Now, he's a premiere member of 
both the X-Men and the Avengers 





Data provided by Marvel. © 2017 MARVEL -++ Data provided by Marvel. © 2017 MARVEL 
图 9.1 
Kotlin 解决 方案 可 使 最 终 代 码 更 加 简洁 。 其 中 ， 大 多 数 方案 已 在 前 述 章 节 中 有 所 提 及 ， 本 





章 仅 对 其 进行 简要 描述 。 本 章 的 价值 主要 体现 在 : ZEST LP o 
读者 可 下 载 GitHub 上 的 代码 , 对 应 网 址 为 https://github.com/MarcinMoskala/Marvel 

Gallery。 

在 GitHub E, 读者 可 查看 最 终 代 码 并 下 载 ; 或 者 可 使 用 Git 命令 将 其 克隆 至 自己 的 计 

算 机 设备 上 ， 如 下 所 示 : 


git clone git@github.com:MarcinMoskala/MarvelGallery.git 





D 应 用 程序 还 包含 了 采用 Espresso 编写 的 UI 测试 ， 但 并 未 出 现 于 本 章 计 
论 中 ， 以 使 内 容 相 对 简洁 。 
本 章 各 部 分 内 容 在 当前 项 目 中 包含 对 应 的 Git 分 支 ， 以 方便 读者 查看 代码 ， 如 图 9.2 
所 示 。 
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Branch: master v | New pull request 


Switch branches/tags 











Character_Gallery_Network_definition 


Character Gallery Putting it ail together 
Character Gallery View implementation 
Character Profile 


Character search 


»PicicCi»cio!uwi»t'm 


Emply project Ir 
With_ActivityStarter Ir 


v^ master Ir 


图 9.2 

男 外 ， 从 本 地 角度 来 看 ， 在 存储 库 克隆 完毕 后 ， 可 通过 Git 命令 检测 对 应 的 分 支 ， 如 
下 所 示 : 

git checkout Character search 

如 果 读 者 拥有 本 书 的 电子 版 ， 则 可 通过 复制 、 粘 贴 代 码 生 成 当前 应 用 程序 ， 但 需要 
将 文件 置 于 与 当前 数据 包 对 应 的 文件 夹 内 。 通 过 这 一 方式 ， 可 在 项 目 中 生成 更 加 清晰 的 
结构 。 

需要 注意 的 是 , 若 将 本 书 代 码 置 于 另 一 个 文件 夹 中 , 将 产生 如 图 9.3 所 示 的 警告 消息 。 

















Jet 





package com.sample.marvelgallery.view 
图 9.3 


户 可 将 某 个 文件 置 于 任意 文件 夹 中 ,这 将 把 文件 放置 于 所 定义 的 数据 包 对 应 的 路 径 
中 ， 如 图 9.4 所 示 。 
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package com.sample.marvelgallery.view 














@ Change file's package to 'com.sample.marvelgallery.view.common' > 

* Move file to 'com/sample/marvelgallery/view* > 

Ə Change package > 
图 9.4 


读者 可 以 将 此 文件 置 于 正确 的 位 置 处 。 
9.1.2 创建 空 项 目 

















在 实现 各 项 功能 之 前 ， 需 要 利用 MainActivity 建 空 的 Kotlin Android 项 目 ， 第 1 章 曾 
对 此 有 所 讨论 ， 因 而 此 处 仅 对 此 予以 简要 描述 ， 同时， 也 会 逐步 考察 Android Studio 3.0 中 
的 各 项 操作 。 

COD 设置 名 称 、 数 据 包 以 及 新 项 目的 位 置 。 记 住 ， 此 处 须 选 中 Include Kotlin support 
复 选 框 ， 如 图 9.5 所 示 。 





Create New Project x 


^X Create Android Project 





Application name 
MarvelGallery ] 





Company domain 


sample.com ] 





Project location 
Thome/marcin/AndroidProjects/MarvelGallery| ILJ 











Package name 


com.sample.marvelgallery 





C Include C++ support 
Include Kotlin support 
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(2) 可 选择 其 他 Android 版 本 。 当 前 示例 将 此 设置 为 API 16， 如 图 9.6 所 示 。 


YX Target Android Devices 


Select the form factors and minimum SDK 
Some devices require additional SDKs. Low API levels target more devices, but offer fewer API features. 
Phone and Tablet 
API 16: Android 4.1 (Jelly Bean) H 
By targeting API 16 and later, your app wil run on approximately 99.2% of devices. 
DD Wear 
API 21: Android 5.0 (Lollipop) BH 
ow 
API 21: Android 5.0 (Lollipop) Bn 
DD Android Auto 
Z Android Things 
AP 24: Android 7.0 (Nougat) 日 








(eon) WT et) 
图 9.6 


(3) 选取 模板 。 当 前 示例 无 须 使 用 任何 模板 ， 因 而 应 选择 Empty Activity 并 启动 ， 如 
图 9.7 所 示 。 


YX Add an Activity to Mobile 
raum ram Emm 


Add No Activity 


Basic Activity Bottom Navigation Activity 








图 9.7 


I 


应 用 程序 后 ， 用 户 可 看 到 一 个 任务 图 片 库 。 


务 规则 ， 因 而 该 用 例 相 对 复杂 。 因 此 ， 可 将 其 分 解 为 多 
项 任务 ， 如 下 所 示 ard 


H 
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(4) 对 新 创建 的 activity 命名 。 其 中 ， 第 一 个 视图 可 命名 为 MainActivity， 如 图 9.8 所 示 。 
对 于 3x 之 前 的 Android Studio, KA AF FR: 
(1 ) 在 当前 项 目 中 配置 Kotlin( 例如 Ctrl/Cmd + Shift + A 以 及 Configure 
qb Kotlin in project ). 
( 2 ) 将 所 有 Java 类 转换 为 Kotlin( 例如 MainActivity 的 Ctrl/Cmd+Shift+ 
A 和 Convert Java file to Kotlin file )。 














随后 ， 即 可 得 到 包含 空 Activity 的 Kotlin Android Kj 
避 用 程序 ， 如 图 9.8 所 示 。 


9.1.3 任务 图 片 库 


这 一 部 分 内 容 将 实现 单一 用 例 ， 也 就 是 说 ， 在 启动 

















MarvelGallery 

















由 于 需要 显示 视图 , 利用 API 实现 网 络 连 接 以 及 业 


e 视图 实现 。 

e 利用 API 进行 通信 。 

e 任务 显示 的 业务 逻辑 实现 。 
e 整合 操作 。 


下 面 对 此 予以 逐一 实现 。 
1. 视图 实现 图 9.8 
下 面 首先 考察 视图 的 实现 过 程 ， 并 定义 一 个 人 物 角 色 的 外 观 列表 。 出 于 测试 目的 ， 这 


























里 将 定义 多 个 任务 并 对 其 加 以 显示 。 





对 于 MainActivity 布局 的 实现 过 程 ,将 采用 RecyclerView 显示 元 素 列表 、Recycler View 











布局 分 布 于 一 个 单独 的 依赖 项 中 ， 须 添加 app 模块 build.gradle 文件 ， 如 下 所 示 : 


implementation "com.android.support:recyclerview- 
v7:$ android support version" 














android support version 实例 表示 为 一 个 尚未 定义 的 变量 , 其 后 的 原因 可 描述 为 : 对 于 全 部 
的 Android 支持 库 ， 该 版 本 应 保持 一 致 ， 同时， 当 析 取 该 版 本 号 并 作为 一 个 单一 变量 时 ， 
这 一 操作 将 易于 管理 。 相 应 地 ， 对 于 包含 android_support version 引用 的 某 一 个 Android 
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支持 库 ， 应 替换 对 应 的 硬 编码 版 本 ， 如 下 所 示 : 


implementation "com.android.support:appcompat 


v7:$android support version" 
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implementation "com.android.support:design:$android support version" 
implementation "com.android.support:support 


v4:$android support version" 


implementation "com.android.support:recyclerview 


v7:$android support version" 











同时 ， 还 须 设置 支持 库 的 版 本 号 。 对 此 ， 一 种 较 好 的 方法 是 将 其 定义 于 buildscript 的 
build.gradle 项 目 文件 中 ， 并 位 于 kotlin_version 定义 之 后 ， 如 下 所 示 : 


ext.kotlin version = '1.1.4-2' 


ext.android support version - "26.0.1" 





当前 ， 可 查看 MainActivity 布局 的 实现 结果 ， 如 图 9.9 所 示 。 


an 


MarvelGallery 


Aaron Stack 


Abomination 


ma 人 timate) 
Data Drovided by Marvel. © 2017 MARVEL 


图 9.9 








RecyclerView 上 的 人 物 元 素 将 封装 至 SwipeRefreshLayout， 以 支持 手指 滑动 更 新 操作 。 








为 了 保护 漫 威 的 版 权 , 还 应 显示 相关 标签 , 以 告知 














户 数据 











Marvel 所 提供 。activity main 
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(res/layout/activity main.xmD 应 利用 下 列 定义 予以 替换 : 


<?xml version-"1.0" encoding-"utf-8"?» 

<RelativeLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:app-"http://schemas.android.com/apk/res-auto" 
xmlns:tools-"http://schemas.android.com/tools" 
android: id="@+id/charactersView" 
android:layout width="match parent" 
android:layout height-"match parent" 
android:background="@android:color/white" 
android: fitsSystemWindows="true"> 


«android.support.v4.widget.SwipeRefreshLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android: id="@+id/swipeRefreshView" 
android:layout width="match parent" 
android:layout height="match parent"> 


<android.support.v7.widget .RecyclerView 
android: id="@+id/recyclerView" 
android:layout width="match parent" 
android:layout height="match parent" 
android:scrollbars-"vertical" /> 


«/android.support.v4.widget.SwipeRefreshLayout» 


«TextView 

android:layout width-"match parent" 

android:layout height-"wrap content" 

android:layout alignParentBottom-"true" 

android:background="@android:color/white" 

android: gravity="center" 

android:text="@string/marvel copyright notice" /> 
</RelativeLayout> 


里 ， 需 要 将 版 权 注意 事项 添加 至 字符 串 中 res/values/strings.xmD , 40 F tas: 


«string name-"marvel copyright notice"> 
Data provided by Marvel. . 2017 MARVEL 
«/string» 


图 9.10 显示 了 预览 效果 。 




















5593: Marvel Gallery 项 目 实战 


MarvelGallery 


sos 











Data provided by Marvel. © 2017 MARVEL 
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下 一 个 步骤 是 定义 各 项 视图 。 其 中 ， 每 个 元 素 项 将 显示 为 正方 形 。 对 此 ， 需 要 定义 


个 持 有 正方 形 形 状 的 视图 (将 其 置 于 view/views 中 )， 如 下 所 示 : 


package com.sample.marvelgallery.view.views 


import android.util.AttributeSet 
import android.widget.FrameLayout 
import android.content.Context 


class SquareFrameLayout @JvmOverloads constructor( // 1 
context: Context, 
attrs: AttributeSet? = null, 
defStyleAttr: Int - O 

) : FrameLayout(context, attrs, defStyleAttr) ( 


override fun onMeasure(widthMeasureSpec: Int, 
heightMeasureSpec: Int) { 


super .onMeasure (widthMeasureSpec, widthMeasureSpec) // 2 


} 














针对 注释 1， 当 使 用 JymOverloads 注解 时 ， 可 避免 调整 在 Android 中 设置 自 定义 视图 的 构 








造 函 数 ， 有 具体 内 容 可 参考 第 4 章 ， 对 于 注释 2， 强 制 元 素 的 高 度 与 宽度 相同 。 
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利用 SquareFrameLayout， 可 定义 图 库 各 项 的 布局 ， 如 图 9.11 所 示 。 
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图 9.11 
同时 ， 还 须 定义 ImageView 以 显示 人 物 角色 图 像 ， 以 及 TextView 以 显示 其 名 称 。 实 
际 上 ， 虽 然 SquareFrameLayout 表示 为 FrameLayout (包含 固定 高 度 )， 但 其 子 元 素 (图像 
和 文本 ) 在 默认 时 彼此 重合 。 下 面 将 布局 添加 至 res/layout 的 item_character.xml 文件 中 ， 
如 下 所 示 : 


// ./res/layout/item character.xml 








<com.sample.marvelgallery.view.views.SquareFrameLayout 

xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:tools-"http://schemas.android.com/tools" 
android:layout width-"match parent" 


android:layout height-"wrap content" 
android:gravity-"center horizontal" 
android:orientation-"horizontal" 
android:padding="@dimen/element padding" 


«ImageView 
android: id="@+id/imageView" 
android:layout width="match parent" 
android:layout height="match parent"/> 


<TextView 
android: id="@+id/textView" 
android:layout width="match parent" 
android: layout height-"match parent" 
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android:gravity-"center" 

android:paddingLeft-"10dp" 

android:paddingRight="10dp" 

android: shadowColor="#111" 

android: shadowDx="5" 

android: shadowDy="5" 

android: shadowRadius="0.01" 

android: textColor="@android:color/white" 

android:textSize="@dimen/standard text size" 

tools:text="Some name" /> 
</com.sample.marvelgallery.view. views .SquareFrameLayout> 








注意 ， 此 处 使 用 了 诸如 element padding 这 一 类 值 (定义 于 dimens)， 下 面 将 其 添加 至 res/ 
values 中 的 dimen.xml 文件 中 ， 如 下 所 示 : 


MA 


H 


























<?xml version-"1.0" encoding-"utf-8"?» 

«resources» 
<dimen name-"character header height">240dp</dimen> 
<dimen name-"standard text size">20sp</dimen> 
<dimen name-"character description padding">10dp</dimen> 
<dimen name-"element padding"»10dp«/dimen» 

</resources> 


可 看 到 ， 每 个 元 素 都 需要 显示 人 物 角色 的 冰川 及 其 图 像 。 因 此 ， 角 色 模 型 须 包 含 两 项 





属性 。 下 面 针对 某 个 角色 定义 一 个 简单 的 模型 ， 如 下 所 示 : 


Hy 





H 


package com.sample.marvelgallery.model 


data class MarvelCharacter( 
val name: String, 
val imageUrl: String 


) 


当 采 用 RecyclerView 显示 元 素 列表 时 ， 需 要 实现 列表 RecyclerView 和 数据 项 适配器 。 
， 列 表 适 配器 用 于 管理 列表 中 的 全 部 元 素 ; 而 数据 项 适配器 则 是 针对 单一 数据 项 类 型 




















的 适配器 。 相 应 地 ， 此 处 仅 需要 一 个 数据 项 适配器 ， 因 为 当前 仅 显示 单一 的 数据 项 类 型 。 
一 种 假设 是 ， 未 来 还 可 能 在 列表 中 加 入 其 他 类 型 的 元 素 ， 例 如 漫画 或 广告 。 在 大 多 数 项 目 


H 


I 





, 





类 中 。 


H 














往往 会 存在 多 个 单一 列表 ， 对 此 ， 一 种 较 好 的 做 法 是 将 公共 行为 抽取 至 某 个 独立 抽象 








尽管 该 示例 旨 在 展示 Kotlin 在 大 型 项 目 中 的 应 用 方式 , 但 这 里 将 定义 一 个 抽象 列表 适 








配器 ， 并 将 其 命名 为 RecyclerListAdapter， 以 及 一 个 命名 为 ItemAdapter 的 抽象 数据 项 适 配 
器 。 其 中 ，ItemAdapter 的 定义 如 下 所 示 : 
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package com.sample.marvelgallery.view.common 


import android.support.v7.widget.RecyclerView 
import android.support.annotation.LayoutRes 
import android.view.View 


abstract class ItemAdapter«T : RecyclerView.ViewHolder» 
(@LayoutRes open val layoutId: Int) ( // 1 


abstract fun onCreateViewHolder(itemView: View): T // 2 


@Suppress ("UNCHECKED CAST") // 1 

fun bindViewHolder (holder: RecyclerView.ViewHolder) { 
(holder as T) .onBindViewHolder() // 1 

} 


abstract fun T.onBindViewHolder() // 1, 3 

} 

针对 注释 1， 须 作为 类 型 参数 传递 一 个 加 载 器 ， 并 可 在 其 字段 上 直接 进行 操作 。 该 加 
载 器 创建 于 onCreateViewHolder 中 ， 因 而 可 知 其 类 型 通常 为 类 型 参数 T。 因 此 ， 可 将 该 加 
载 器 转换 为 bndViewHolder 上 的 T， 并 将 其 用 作 针对 onBindViewHolder 的 接收 器 对 象 。 

对 于 注释 2， 函 数 用 于 创建 视图 加 载 器 。 在 大 多 数 时候 ， 可 表示 为 一 个 单一 的 表达 式 
函数 ， 且 仅 调用 构造 函数 。 

对 于 注释 3， 在 onBindViewHolder 函数 中 ， 将 设置 数据 项 视图 上 的 全 部 数值 。 

RecyclerListAdapter 的 定义 如 下 所 示 : 


package com.sample.marvelgallery.view.common 





import android.support.v7.widget.RecyclerView 
import android.view.LayoutInflater 
import android.view.ViewGroup 


open class RecyclerListAdapter( // 1 
var items List«AnyItemAdapter» = listOf() 
) : RecyclerView.Adapter<RecyclerView.ViewHolder>() { 


override final fun getItemCount() = items.size // 4 


override final fun getlItemViewType (position: Int) = 
items[position].layoutId // 3, 4 
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override final fun onCreateViewHolder (parent: ViewGroup, 
layoutId: Int): RecyclerView.ViewHolder ( // 4 
val itemView — LayoutInflater.from(parent.context) 
.inflate(layoutId, parent, false) 
return items.first 
{ it.layoutId == layoutId }.onCreateViewHolder(itemView) // 3 
) 


override final fun onBindViewHolder 
(holder: RecyclerView.ViewHolder, position: Int) ( // 4 
items[position].bindViewHolder (holder) 
} 
) 


typealias AnyItemAdapter - ItemAdapter 
«out RecyclerView.ViewHolder» // 5 

针对 注释 1， 此 处 未 采用 抽象 机 制 ， 其 原因 在 于 ， 无 须 使 用 任何 子 元 素 即 可 初始 化 并 加 以 
使 用 。 针 对 不 同 的 列表 ， 可 定义 子 元 素 ， 进 而 设置 自 定义 方法 ， 对 于 注释 2， 将 数据 项 保 
存 于 列表 中 ; 对 于 注释 3， 将 采用 布局 区 分 数据 项 类 型 。 据 此 ， 将 无 法 使 用 同一 列表 上 包 
含 相同 布局 的 两 个 数据 项 适配器 ， 但 该 方案 可 使 问题 得 以 简化 ， 对 于 注释 4， 对 应 方法 覆 
写 了 RecyclerView.Adapter 中 的 方法 ， 但 也 使 用 了 final 修饰 符 限 制 子 元 素 中 的 覆 写 操作 。 
扩展 了 RecyclerListAdapter 的 全 部 列表 应 对 数据 项 进行 操作 ， 对 于 注释 5， 定 义 了 类 型 别 
名 以 简化 任意 的 TtemAdapter 定义 。 

当 采 用 上 述 定义 时 , 可 定义 MainListAdapter( 针 对 人 物 列表 的 适配器 ) 以 及 CharacterItem 
Adapter〔 针 对 列表 上 数据 项 的 列表 )。MainListAdapter 的 定义 如 下 所 示 : 


package com.sample.marvelgallery.view.main 











import com.sample.marvelgallery.view.common.AnyItemAdapter 
import com.sample.marvelgallery.view.common.RecyclerListAdapter 


class MainListAdapter(items: List<AnyItemAdapter>) 
RecyclerListAdapter (items) 


在 该 项 目 中 ， 无 须 使 用 定义 于 MainListAdapter 中 的 特定 方法 ， 但 为 了 展示 其 定义 的 简单 
性 ， 下 列 代码 展示 了 包含 附加 方法 Cadd 和 delete) 的 MainListAdapter。 


class MainListAdapter(items: List<AnyItemAdapter>) 
RecyclerListAdapter(items) ( 








fun add(itemAdapter: AnyItemAdapter) { 


+ 296 。 零 基 础 学 Kotlin 编程 





items += itemAdapter) 

val index = items.indexOf (itemAdapter) 
if (index == -1) return 
notifyItemInserted (index) 


fun delete(itemAdapter: AnyItemAdapter) ( 
val index = items.indexOf (itemAdapter) 
if (index -1) return 
items -- itemAdapter 
notifyItemRemoved (index) 





) 
CharacterItemA dapter 的 定义 如 下 所 示 : 


package com.sample.marvelgallery.view.main 


import android.support.v7.widget.RecyclerView 

import android.view.View 

import android.widget.ImageView 

import android.widget.TextView 

import com.sample.marvelgallery.R 

import com.sample.marvelgallery.model.MarvelCharacter 
import com.sample.marvelgallery.view.common.ItemAdapter 
import com.sample.marvelgallery.view.common.bindView 
import com.sample.marvelgallery.view.common.loadImage 


class CharacterItemAdapter ( 
val character: MarvelCharacter // 1 
):ItemAdapter«CharacterItemAdapter.ViewHolder» (R.layout.item character) { 


override fun onCreateViewHolder (itemView: View) = ViewHolder (itemView) 


override fun ViewHolder.onBindViewHolder() { // 2 
textView.text = character.name 
imageView.loadImage (character.imageUrl) // 3 


class ViewHolder(itemView: View) : RecyclerView.ViewHolder (itemView) 
t 

val textView by bindView<TextView>(R.id.textView) // 4 

val imageView by bindView<ImageView>(R.id.imageView) // 4 
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针对 注释 1, MarvelCharacter 通过 构造 函数 传递 ， 针 对 注释 2, onBindViewHolder 上 








于 设 














置 视图 ， 并 定义 为 ItemAdapter 中 的 抽象 成 员 扩展 函数 。 据 此 ， 可 在 其 函数 体 中 显 式 地 使 

















H textView 和 imageView; 对 于 注释 3, 函数 loadImage 尚未 定义 ， 稍 后 将 其 定义 为 扩 








定 至 视图 元 素 上 。 








展 函 
数 ， 对 于 注释 4， 在 视图 加 载 器 中 ， 通 过 bindView 函数 〈 稍 后 将 对 其 加 以 定义 )， 将 属性 


在 内 部 ， 可 使 用 loadImage 和 bindView 函数 〈 尚 未 定义 )。 另 外 ，bindView 表示 为 针 
对 RecyclerView.ViewHolder 的 顶级 扩展 函数 ， 并 提供 了 延迟 委托 (并 通过 其 ID 提供 一 个 


视图 )， 如 下 所 示 : 


// ViewExt.kt 
package com.sample.marvelgallery.view.common 


import android.support.v7.widget.RecyclerView 
import android.view.View 


fun «T : View» RecyclerView.ViewHolder.bindView(viewId: Int) 
= lazy { itemView.findViewById«T» (viewId) } 


除 此 之 外 ， 还 需 定义 loadImage 扩展 函数 ， 以 帮助 我 们 从 URL 下 载 一 幅 图 像 ， 并 将 其 
FLA ImageView。 对 此 ， 可 使 用 两 个 典型 的 库 ， 即 Picasso 和 Glide。 此 处 选择 了 Glide. Xf 


此 ， 需 要 在 build.gradle 中 添加 依赖 项 ， 如 下 所 示 : 


implementation "com.android.support:recyclerview 
v7:$ android support version" 
implementation "com.github.bumptech.glide:glide:$glide version" 


确定 项 目 build.gradle 中 的 当前 版 本 ， 如 下 所 示 : 


ext.android support version = "26.0.0" 
ext.glide version - "3.8.0" 


添加 权限 ， 并 在 AndroidManifest 中 使 用 互联 网 ， 如 下 所 示 : 








<manifest xmlns:android="http://schemas.android.com/apk/res/android" 


package="com.sample.marvelgallery"> 
<uses-permission android:name="android.permission.INTERNET" /> 
<application 


最 后 ， 可 针对 ImageView 类 定义 loadImage 扩展 函数 ， 如 下 所 示 : 


// ViewExt.kt 
package com.sample.marvelgallery.view.common 
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import android.support.v7.widget.RecyclerView 
import android.view.View 

import android.widget.ImageView 

import com.bumptech.glide.Glide 


fun «T : View» RecyclerView.ViewHolder.bindView(viewId: Int) 


= lazy ( itemView.findViewById«T» (viewId) } 


fun ImageView.loadImage(photoUrl: String) ( 
Glide.with (context) 
. load (photoUrl) 
.into (this) 
} 


至 此 , 可 定义 Activity 显示 该 列表 ， 并 使 用 Kotlin Android 扩展 插件 ， 用 于 简化 代码 中 
视图 元 素 的 访问 行为 。 具 体 过 程 十 分 简单 ， 即 在 build.gradle 模块 中 加 入 kotlin-android- 


extensions 插件 ， 如 下 所 示 : 


apply plugin: 'com.android.application' 
apply plugin: 'kotlin-android' 
apply plugin: 'kotlin-android-extensions' 


And we have some view defined in layout: 


<TextView 
android: id="@+id/nameView" 
android:layout width="wrap content" 
android:layout height-"wrap content" /> 


fe Activity 中 导入 指向 该 视图 的 引用 ， 如 下 所 示 : 


import kotlinx.android.synthetic.main.activity main.* 


随后 


m 
a 
IM 








接 下 来 ， 通 过 名 称 即 可 直接 访问 View 元 素 ， 且 无 须 使 用 find ViewById 方法 或 定义 注解 ， 


如 下 所 示 : 


nameView.text = "Some name" 


在 当前 项 目的 全 部 Activity H, 均 会 使 用 Kotlin Android 扩展 。 下 了 
以 显示 包含 图 像 的 人 物 角 色 列 表 ， 如 下 所 示 : 


package com.sample.marvelgallery.view.main 








import android.os.Bundle 
import android.support.v7.app.AppCompatActivity 


再 定义 Main Activity, 
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import android.support.v7.widget.GridLayoutManager 


import android.view.Window 
import com.sample.marvelgallery.R 


import com.sample.marvelgallery.model.MarvelCharacter 
import kotlinx.android.synthetic.main.activity main.* 


class MainActivity : AppCompatActivity() ( 


private val characters - listof( // 1 
MarvelCharacter(name = "3-D Man", imageUrl = 
"http://i.annihil.us/u/prod/marvel/i/mg/c/e0/535fecbbb9784.jpg"), 
MarvelCharacter(name = "Abomination (Emil Blonsky)", imageUrl = 
"http://i.annihil.us/u/prod/marvel/i/mg/9/50/4ce18691cbf04.jpg") 


) 


override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate (savedInstanceState) 
requestWindowFeature (Window.FEATURE NO TITLE) // 2 
setContentView(R.layout.activity main) 
recyclerView.layoutManager - GridLayoutManager(this, 2) // 3 
val categoryItemAdapters - characters 
.map(::CharacterItemAdapter) // 4 
recyclerView.adapter = MainListAdapter (categoryItemAdapters 


) 


对 于 注释 1， 定 义 了 一 个 可 供 显 示 的 临时 人 物 角 色 列 表 ; 
对 于 注释 2， 由 于 并 未 显示 标题 ， 此 处 使 用 了 当前 窗口 特 
TE; 对 于 注释 3, 使 用 GridLayoutManager 作为 RecyclerView 
布局 管理 器 ， 以 实现 网 格 效 果 ; 对 于 注释 4， 可 通过 














CharacterItem Adapter 构造 函数 引用 ， 并 根据 














建 数据 项 适配器 。 


色 人 物 创 


至 此 ， 可 编译 当前 项 目 ， 最 终 效果 如 图 9.12 所 示 。 


2. 网 络 定 义 


截止 到 目前 ， 所 显示 的 数据 均 在 应 用 程序 内 以 硬 编码 
方式 体现 ， 除 此 之 外 ， 还 需要 使 用 到 源 自 Marvel API 的 数 
据 。 对 此 ， 须 定义 相应 的 网 络 机 制 ， 并 从 服务 器 处 接收 数 
据 。 这 里 将 使 用 一 个 较为 流行 的 Android 库 Retrofit， 进 而 
简化 网 络 操作 ， 同 时 ， 还 将 用 到 另 一 个 库 RxJava， 用 于 人 
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图 9.12 
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现 响应 式 编程 。 对 于 这 两 个 库 ， 将 仅 使 用 基本 的 功能 ， 并 尽 可 能 简化 应 用 过 程 。 在 应 用 ; 





程 中 ， 
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需要 在 build.gradle 模块 中 添加 下 列 依赖 项 : 


dependencies { 


) 


implementation "org.jetbrains.kotlin:kotlin-stdlib-jre7: 
$kotlin version" 

implementation "com.android.support:appcompat-v7: 

$android support version" 

implementation "com.android.support:recyclerview-v7: 

$android support version" 

implementation "com.github.bumptech.glide:glide:$glide version" 


// RxJava 
implementation "io.reactivex.rxjava2:rxjava:$rxjava version" 


// RxAndroid 
implementation "io.reactivex.rxjava2:rxandroid:$rxandroid version" 


// Retrofit 

implementation (["com.squareup.retrofit2:retrofit:$retrofit version", 
"com.squareup.retrofit2:adapterrxjava2:$retrofit v 
ersion", 
"com.squareup.retrofit2:convertergson:$retrofit ve 
rsion", 
"com.squareup.okhttp3:okhttp:$okhttp version", 
"com.squareup.okhttp3:logginginterceptor:$okhttp v 
ersion"]) 


testImplementation 'junit:junit:4.12' 
androidTestImplementation 
'com.android.support.test:runner:1.0.0" 
androidTestImplementation 
'com.android.support.test.espresso:espresso-core:3.0.0" 


项 目 build.gradle 中 另 一 个 版 本 定义 如 下 所 示 : 


ext.kotlin version = '1.1.3-2' 
ext.android support version = "26.0.0" 
ext.glide version - "3.8.0" 
ext.retrofit version = '2.2.0' 


ext.okhttp version = '3.6.0' 
ext.rxjava version = "2.1.2" 
ext.rxandroid version = '2.0.1" 
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我 们 已 经 获得 定义 于 AndroidManifest 中 的 网 络 授权 ， 因 而 无 须 再 次 添加 。 简 单 的 
Retrofit 定义 如 下 所 示 : 


val retrofit by lazy ( makeRetrofit() } // 1 





private fun makeRetrofit(): Retrofit = Retrofit.Builder() 
-baseUrl ("http://gateway.marvel.com/vl/public/") // 2 
-build() 
对 于 注释 1， 可 将 retrofit 实例 视 为 延迟 顶级 属性 ;而 对 于 注释 2， 此 处 定义 了 baseUrl. 
除 此 之 外 , Retrofit 还 包含 一 些 附加 需求 条 件 , 且 需 要 了 予以 满足 。 例如 , 须 添加 转换 器 ， 
以 实现 Retrofit 和 RxJava 之 间 的 整合 应 用 ， 并 将 对 象 序列 化 为 JSON。 另 外 ， 还 需要 使 用 
到 拦截 器 以 提供 Marvel API 所 需 的 数据 头 和 额外 的 查询 操作 。 鉴于 当前 示例 仅 是 一 类 小 型 
日程 序 ， 因 而 可 将 全 部 所 需 元 素 定义 为 顶级 函数 。Retrofit 的 完整 定义 如 下 所 示 : 


// Retrofit.kt 
package com.sample.marvelgallery.data.network.provider 
































应 


import com.google.gson.Gson 

import okhttp3.OkHttpClient 

import retrofit2.Retrofit 

import retrofit2.adapter.rxjava2.RxJava2CallAdapterFactory 
import retrofit2.converter.gson.GsonConverterFactory 
import java.util.concurrent.TimeUnit 


val retrofit by lazy { makeRetrofit() } 


private fun makeRetrofit(): Retrofit = Retrofit.Builder() 
.baseUrl ("http://gateway.marvel.com/vl/public/") 
.client (makeHttpClient () ) 
.addConverterFactory (GsonConverterFactory.create(Gson())) // 1 
.addCallAdapterFactory (RxJava2CallAdapterFactory.create()) // 2 
.build() 


private fun makeHttpClient() = OkHttpClient.Builder() 
.connectTimeout(60, TimeUnit.SECONDS) // 3 
.readTimeout(60, TimeUnit.SECONDS) // 4 
-addInterceptor (makeHeadersInterceptor()) // 5 
.addInterceptor (makeAddSecurityQueryInterceptor()) // 6 
.addInterceptor (makeLoggingInterceptor()) // 7 
-build() 


于 注释 1, 添加 转换 器 以 支持 对 象 的 ISON 序列 化 操作 和 反 序 列 化 操作 (使 用 GSON 库 ); 











> 
di 
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对 于 注释 2， 针 对 网 络 请 求 的 返回 值 ， 添 加 转换 器 以 使 RxJava2 类 型 (包括 Observable 和 











Single) 为 Observable; 对 于 注释 3， 添 加 自 定义 拦截 器 ， 并 对 所 有 
下 列 代码 定义 了 所 需 的 拦截 器 。 其 中 ，makeHeadersInterceptor 月 





准 的 数据 头 。 


// HeadersInterceptor.kt 








package com.sample.marvelgallery.data.network.provider 


import okhttp3.Interceptor 


fun makeHeadersInterceptor() = Interceptor ( chain -> // 1 


chain.proceed (chain. request () .newBuilder () 
-addHeader ("Accept", "application/json") 
-addHeader ("Accept-Language", "en") 


.addHeader ("Content-Type", "application/json") 


-build()) 
} 








对 于 注释 1， 拦 截 器 表示 为 SAM， 因 而 可 采用 SAM 构造 函数 对 




















当 在 调试 模式 下 运行 当前 应 用 程序 时 , makeLoggingInterceptor 函数 用 于 显示 控制 台 日 


志 ， 如 下 所 示 : 


// LoggingInterceptor.kt 


加 以 定义 。 


package com.sample.marvelgallery.data.network.provider 


import com.sample.marvelgallery.BuildConfig 
import okhttp3.logging.HttpLoggingInterceptor 


内 容 加 以 定义 。 
日 于 向 各 个 请 求 添加 标 











fun makeLoggingInterceptor() = HttpLoggingInterceptor().apply { 
level = if (BuildConfig.DEBUG) HttpLoggingInterceptor.Level.BODY 


else HttpLoggingInterceptor.Level.NONE 
} 


makeAddRequiredQueryInterceptor 函数 稍 显 复杂 ， 该 函数 用 于 提供 Marvel API 所 用 
查询 参数 ， 进 而 对 用 户 进行 验证 。 这 一 类 参数 须 采用 MDS 算法 计算 哈 希 值 ， 同 时 还 须 使 
到 源 自 Marvel API 的 公 钥 和 私 钥 。 在 https://developer.marvel.com/ E, 每 名 月 





























己 的 密 钥 。 待 操作 完毕 后 ， 须 将 其 置 入 gradle.properties 文件 中 ， 如 下 所 示 : 


org.gradle.jvmargs--Xmx1536m 


marvelPublicKey-REPLEACE WITH YOUR PUBLIC MARVEL KEY 
marvelPrivateKey-REPLEACE WITH YOUR PRIVATE MARVEL KEY 
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的 
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另外 ， 还 须 在 defaultConfig 部 分 的 build.gradle 模块 中 加 入 下 列 定义 : 


defaultConfig { 
applicationId "com.sample.marvelgallery" 
minSdkVersion 16 
targetSdkVersion 26 
versionCode 1 
versionName "1.0" 
testInstrumentationRunner 
"android.support.test.runner.AndroidJUnitRunner" 
buildConfigField("String", "PUBLIC KEY", "\"S${marvelPublicKey}\"") 
buildConfigField("String", "PRIVATE KEY", "\"${marvelPrivateKey}\"") 


l 
待 项 目 重新 构造 完毕 后 ， 可 通过 BuildConfig PUBLIC KEY 和 BuildConfig PRIVATE. KEY 





访问 相关 值 。 通 过 此 类 密 钥 ， 可 生成 Marvel API 所 需 的 查询 参数 ， 如 下 所 


// QueryInterceptor.kt 
package com.sample.marvelgallery.data.network.provider 


import com.sample.marvelgallery.BuildConfig 
import okhttp3.Interceptor 


fun makeAddSecurityQueryInterceptor() = Interceptor ( chain -> 
val originalRequest = chain.request () 
val timeStamp = System.currentTimeMillis() 


// Url customization: add query parameters 
val url - originalRequest.url().newBuilder() 
.addQueryParameter("apikey", BuildConfig.PUBLIC KEY) // 1 
.addQueryParameter("ts", "$timeStamp") // 1 
-addQueryParameter ("hash", calculatedMd5 (timeStamp.toString()+ 
BuildConfig.PRIVATE KEY + BuildConfig.PUBLIC KEY)) // 1 
-build() 


// Request customization: set custom url 
val request - originalRequest 
.newBuilder () 
-url (url) 
.build() 


chain.proceed (request) 
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关于 注释 1， 我 们 需要 提供 3 个 额外 查询 ， 如 下 所 示 。 
eapikey: 包含 了 当前 的 公 钥 。 
ets: 仅 包 含 了 设备 的 时 间 〈 以 毫秒 计 )， 用 于 改善 下 一 次 查询 所 提供 的 哈 希 值 的 安全 性 。 
e hash: 根据 时 间 戳 、 私 钥 和 公 钥 〈 逐 一 保存 在 独立 的 String H) 计算 为 MD5 哈 希 值 。 
于 计算 MDS 哈 希 值 的 函数 定义 如 下 所 示 : 


// MD5 .kt 
package com.sample.marvelgallery.data.network.provider 




















import java.math.BigInteger 
import java.security.MessageDigest 


/** 

* Calculate MD5 hash for text 

* @param timeStamp Current timeStamp 

* @return MDS hash string 

aye 

fun calculatedMd5 (text: String): String { 
val messageDigest = getMd5Digest (text) 
val md5 = BigInteger(1, messageDigest) .toString (16) 
return "0" * (32 - md5.length) + md5 // 1 

) 


private fun getMd5Digest (str: String): ByteArray = 
MessageDigest .getInstance ("MD5") .digest (str. toByteArray () ) 


private operator fun String.times(i: Int) = (1..i).fold("") { acc, -» acc+ 

this } 
关于 注释 1， 若 小 于 32 位 ， 则 使 用 时 间 扩展 操作 符 ， 并 利用 0 值 填 充 。 

之 前 曾 定义 了 拦截 器 ， 因 而 可 在 此 定义 实际 的 API 方法 。Marvel API 涵盖 了 大 量 的 数 
据 模型 ， 并 以 此 体现 人 物 角色 、 列 表 等 内 容 。 相 应 地 ， 可 将 其 定义 为 单独 的 类 ， 并 称 之 为 
数据 传输 对 象 (DTO)。 下 列 代 码 定义 了 所 需 的 对 象 。 


package com.sample.marvelgallery.data.network.dto 
class DataContainer<T> { 
var results: T? = null 


} 


package com.sample.marvelgallery.data.network.dto 
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class DataWrapper<T> { 
var data: DataContainer<T>? = null 


package com.sample.marvelgallery.data.network.dto 
class ImageDto { 


lateinit var path: String // 1 
lateinit var extension: String // 1 


val completeImagePath: String 
get() = "Spath.$extension" 


package com.sample.marvelgallery.data.network.dto 


class CharacterMarvelDto { 
lateinit var name: String // 1 
lateinit var thumbnail: ImageDto // 1 


val imageUrl: String 
get() = thumbnail.completeImagePath 
} 


关于 注释 1， 针 对 未 提供 的 数据 值 ， 应 设置 相应 的 默认 值 ， 而 强制 值 可 采用 lateinit 作 
为 前 级 。 

Retrofit 采用 反射 生成 HTTP 请 求 〈 根 据 接口 定义 )， 这 也 是 定义 HTTP 请 求 接口 的 实 
现 方式 ， 如 下 所 示 : 


package com.sample.marvelgallery.data.network 














import com.sample.marvelgallery.data.network.dto.CharacterMarvelDto 
import com.sample.marvelgallery.data.network.dto.DataWrapper 

import io.reactivex.Single 

import retrofit2.http.GET 

import retrofit2.http.Query 


interface MarvelApi ( 
QGET ("characters") 


fun getCharacters( 
@Query ("offset") offset: Int?, 
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GQuery("limit") limit: Int? 
): Single<DataWrapper<List<CharacterMarvelDto>>> 
} 


根据 这 一 定义 ， 最 终 可 获得 人 物 角 色 列 表 ， 如 下 所 示 : 


retrofit.create (MarvelApi::class.java) // 1 
-getCharacters(0, 100) // 2 
-subscribe(( /* code */ J) 77 3 


针对 注释 1， 可 使 用 retrofit 实例 创建 某 个 对 象 ， 并 根据 MarvelApi 接口 定义 生成 HITP 请 
求 ; 对 于 注释 2， 将 创建 observable 并 将 调用 传递 至 API; 对 于 注释 3， 通 过 订阅 功能 ， 将 
发 送 HTTP 请 求 ， 并 启动 响应 监听 。 第 一 个 参数 表示 为 当前 回调 ， 并 在 成 功 接收 响应 时 被 
调用 。 

上 述 网 络 定义 可 满足 要 求 ， 但 还 可 采用 更 优 的 方式 予以 实现 。 目 前 ， 最 大 的 问题 是 需 
要 在 DTO 对 象 上 进行 操作 ， 而 非 自己 的 数据 模型 对 象 。 对 于 映射 机 制 ， 须 定义 一 个 附加 
层 。 对 此 ， 可 采用 存储 库 模式 。 当 实现 单元 测试 时 ， 该 模式 十 分 有 用 ， 其 原因 在 于 : 可 模 
拟 存 储 库 而 不 是 API 整体 定义 。 这 也 是 我 们 期 望 持 有 的 储存 库 定义 ， 如 下 所 示 : 


package com.sample.marvelgallery.data 





















































import com.sample.marvelgallery.model.MarvelCharacter 
import io.reactivex.Single 


interface MarvelRepository ( 


fun getAllCharacters(): Single<List<MarvelCharacter>> 
} 


MarvelRepository 的 实现 过 程 如 下 所 示 : 
package com.sample.marvelgallery.data 
import com.sample.marvelgallery.data.network.MarvelApi 
import com.sample.marvelgallery.data.network.provider.retrofit 
import com.sample.marvelgallery.model.MarvelCharacter 
import io.reactivex.Single 
class MarvelRepositoryImpl : MarvelRepository { 


val api = retrofit.create (MarvelApi::class.java) 


override fun getAllCharacters(): Single<List<MarvelCharacter>> = 
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api.getCharacters( 
offset = 0, 
limit = elementsOnListLimit 
) -map { 
it.data?.results.orEmpty().map(::MarvelCharacter) // 1 
) 


companion object ( 
const val elementsOnListLimit = 50 
j 
) 
对 于 注释 1， 可 获得 DTO 元 素 列 表 ， 并 通过 构造 函数 引用 将 其 映射 至 MarvelCharacter 中 。 
为 了 保证 正常 工作 ， 需 要 在 MarvelCharacter 中 定义 额外 的 构造 函数 ， 并 将 Character 
MarvelDto 作为 参数 ， 如 下 所 示 : 


package com.sample.marvelgallery.model 




















import com.sample.marvelgallery.data.network.dto.CharacterMarvelDto 


class MarvelCharacter( 
val name: String, 
val imageUrl: String 
Jut 


constructor(dto: CharacterMarvelDto) : this( 
name = dto.name, 
imageUrl - dto.imageUrl 
) 
H 
相应 地 ， 存 在 不 同 的 方式 提供 MarvelRepository 实例 。 在 大 多 数 常见 实现 中 ，Marvel 
Repository 的 具体 实例 将 作为 参数 传递 至 Presenter。 但 是 ， 关 于 测试 (例如 Espresso 测 
试 )， 情 况 又 当 如 何 ? 此 处 并 不 打算 测试 MarvelAPI， 以 及 在 此 基础 上 的 UI 测试 。 有 具体 的 
解决 方案 可 描述 为 : 制定 某 种 机 制 并 在 运行 期 内 生成 标准 实现 ， 同 时 可 针对 测试 目的 设置 
不 同 的 实现 方式 。 对 此 ， 下 列 代 码 显 示 了 此 类 机 制 的 通用 实现 方案 (将 其 置 于 数据 中 ): 


package com.sample.marvelgallery.data 











abstract class Provider<T> { 


abstract fun creator(): T 
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private val instance: T by lazy ( creator() } 
var testingInstance: T? = null 


fun get(): T = testingInstance ?: instance 


此 处 并 不 打算 定义 自己 的 Provider， 而 是 使 用 Dependency Injection 库 ， 
@ 例如 Dagger À Kodein, # Android FA, Dagger 十 分 常见 ， 但 当前 示例 
并 不 打算 使 用 Dagger， 以 避免 对 不 熟悉 该 库 的 开发 人 员 带 来 不 必要 的 麻烦 。 

针对 于 此 ， 可 令 MarvelRepository 伴生 对 象 提供 者 扩展 上 述 类 ， 如 下 所 示 ; 


package com.sample.marvelgallery.data 





import com.sample.marvelgallery.model.MarvelCharacter 
import io.reactivex.Single 


interface MarvelRepository ( 
fun getAllCharacters(): Single<List<MarvelCharacter>> 


companion object : Provider«MarvelRepository»() ( 
override fun creator() = MarvelRepositoryImpl() 


$ 
根据 上 述 定义 ， 可 通过 MarvelRepository 伴生 对 象 获得 MarvelRepository 实例 ， 如 下 


val marvelRepository = MarvelRepository.get () 
这 将 表示 为 MarvelRepositoryImpl 的 延迟 实例 ， 直 至 设置 了 testingInstance 属性 的 非 空 值 ， 
如 下 所 示 : 
MarvelRepository.get() // Returns instance of MarvelRepositoryImpl 
MarvelRepository.testingInstance- object: MarvelRepository ( 


override fun getAllCharacters(): Single<List<MarvelCharacter>> 
= Single.just (emptyList () ) 


MarvelRepository.get()//returns an instance of an anonymous class in 
which the returned list is always empty. 
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此 类 构造 方式 十 分 有 用 ， 并 支持 基于 的 UI 测试 。 相 应 地 ， 项 目 中 体现 了 针对 元 素 履 写 的 
具体 应 用 ， 读 者 可 在 GitHub 上 对 其 进行 查看 。 本 节 并 未 对 此 予以 展示 ， 对 于 不 太 熟悉 测 
试 机 制 的 开发 人 员 来 讲 , 这 也 降低 了 理解 难度 。 对 此 , 读者 可 访问 https://github.com/Marcin 
Moskala/MarvelGallery/blob/ master/app/src/androidTest/java/com/sample/。 

最 后 ， 通 过 人 物 角色 图 片 库 的 显示 业务 逻辑 实现 ， 可 将 存储 库 与 视图 进行 连接 。 


3. 业务 逻辑 实现 


前 述 内 容 实现 了 视图 和 存储 库 部 分 ， 下 面 将 考察 最 终 的 业务 逻辑 。 针 对 于 此 ， 需 要 获 
得 人 物 角 色 列 表 ， 并 在 用 户 进 入 相关 场景 或 刷新 屏幕 时 显示 列表 项 。 通 过 MVP 模式 ， 可 
从 视图 实现 中 获得 这 一 类 业务 罗 辑 ， 其 精简 后 的 规则 如 下 所 示 。 

e BOSE: 该 层 负责 管理 数据 。 其 中 ， 模 型 的 职责 包括 使 用 API、 缓 存 数据 以 及 管理 

数据 库 等 。 
e 显示 层 : 该 层 表示 为 模型 和 视图 之 间 的 中 间 人 ， 且 应 包含 全 部 显示 逻辑 。 显 示 层 负 
责 响应 于 用 户 的 交互 操作 ， 应 用 并 更 新 模型 和 视图 。 

e 视图 层 ， 该 层 负责 显示 数据 ， 并 将 用 户 交互 事件 转发 至 显示 层 。 

在 该 模式 实现 中 ， 可 将 Activity 视 作 视 图 ， 且 针对 每 个 视图 ， 需 要 生成 一 个 显示 层 。 
一 种 较 好 的 操作 方式 是 编写 单元 测试 , 以 检测 业务 逻辑 规则 是 否 正确 实现 。 为 了 简化 操作 ， 
需要 在 易于 模拟 的 接口 之 后 隐藏 Activity， 以 显示 与 视图 (Activity) 间 的 、 所 有 可 能 的 显 
示 层 交互 。 另 外 ， 此 处 还 将 创建 Activity 中 的 全 部 依赖 项 〈 例 如 MarvelRepository)， 并 作 
为 隐藏 在 接口 后 的 对 象 , 通过 构造 函数 将 其 传递 至 显示 层 中 (例如 , 作为 Marvel Repository 
传递 MarvelRepositoryImpD . 

在 显示 层 中 ， 需 要 实现 下 列 行为 : 

e 当 显 示 层 等 待 某 个 响应 时 ， 将 显示 加 载 动画 。 

e 在 创建 视图 后 ， 人 物 角 色 列 表 将 被 加 载 和 显示 。 

e 在 调用 刷新 方法 后 ， 人 物 角色 列表 将 被 加 载 。 

e 当 API 返 回 人 物 角色 列表 后 ， 将 在 当前 视图 上 被 显示 。 

e 当 API 返 回 一 个 错误 时 ， 将 在 当前 视图 上 显示 。 

不 难 发 现 ， 显 示 层 须 通 过 构造 函数 获取 视图 和 MarvelRepository， 同 时 还 应 指定 相关 
方法 ， 并 在 生成 视图 或 用 户 请 求 被 刷新 时 被 调用 ， 如 下 所 示 : 


package com.sample.marvelgallery.presenter 































































































import com.sample.marvelgallery.data.MarvelRepository 
import com.sample.marvelgallery.view.main.MainView 
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class MainPresenter(val view: MainView, val repository: MarvelRepository) 


t 


fun onViewCreated() ( 


) 


fun onRefresh() ( 


) 
) 


其 中 ， 视 图 需要 定义 对 应 方法 ， 用 于 显示 人 物 角 色 列 表 、 显 示 错 误 消 息 ， 并 在 视图 被 刷 
新 时 显示 进度 条 (将 其 定义 于 view/main 中 ， 并 将 MainActivity 移 至 view/main 中 )， 如 


下 所 示 : 














package com.sample.marvelgallery.view.main.main 


import com.sample.marvelgallery.model.MarvelCharacter 


interface MainView ( 
var refresh: Boolean 
fun show(items: List<MarvelCharacter>) 
fun showError(error: Throwable) 


) 


在 向 显示 








层 添加 逻辑 之 前 ， 下 面 首先 定义 两 个 单元 测试 ， 如 下 所 示 : 


// test source set 
package com.sample.marvelgallery 


import com.sample.marvelgallery.data.MarvelRepository 
import com.sample.marvelgallery.model.MarvelCharacter 
import com.sample.marvelgallery.presenter.MainPresenter 
import com.sample.marvelgallery.view.main.MainView 
import io.reactivex.Single 

import org.junit.Assert.assertEquals 

import org.junit.Assert.fail 

import org.junit.Test 


GSuppress("IllegalIdentifier") // 1 
class MainPresenterTest ( 


@Test 


fun “After view was created, list of characters is loaded and 


displayed*() { 
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assertOnAction ( onViewCreated() ).thereIsSameListDisplayed() 


QTest 
fun ‘New list is shown after view was refreshed*() { 
assertOnAction { onRefresh() }.thereIsSameListDisplayed () 


private fun assertOnAction(action: MainPresenter.() -» Unit) 
= PresenterActionAssertion (action) 


private class PresenterActionAssertion 
(val actionOnPresenter: MainPresenter.() -> Unit) { 


fun thereIsSameListDisplayed() { 
// Given 
val exampleCharacterList = listof(// 2 
MarvelCharacter ("ExampleName", "ExampleImageUrl"), 
MarvelCharacter("Namel", "ImageUrll"), 
MarvelCharacter ("Name2", "ImageUrl2") 


var displayedList: List«MarvelCharacter»? = null 


val view = object : MainView { //3 
override var refresh: Boolean - false 


override fun show(items: List<MarvelCharacter>) { 
displayedList = items // 4 


override fun showError(error: Throwable) ( 
fail() //5 


val marvelRepository = object : MarvelRepository ( // 3 
override fun getAllCharacters(): 
Single<List<MarvelCharacter>> 
= Single.just (exampleCharacterList) // 6 


val mainPresenter = MainPresenter (view, marvelRepository) 
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(0) 3 


// When 
mainPresenter.actionOnPresenter() // 7 


// Then 
assertEquals (exampleCharacterList, displayedList) // 8 


) 


对 于 注释 1, Kotlin 单元 测试 中 允许 使 用 描述 名 称 ， 但 这 将 显示 一 条 警告 消息 。 对 此 ， 须 
隐藏 该 警告 消息 ， 对 于 注释 2， 定 义 一 个 可 显示 的 人 物 角色 列表 ， 对 于 注释 3， 定 义 视图 
和 存储 库 ， 并 以 此 创建 一 个 显示 层 ， 对 于 注释 4， 当 显示 元 素 列 表 时 ， 应 将 其 设置 为 可 显 
示 列 表 ; 对 于 注释 5， 若 showError 被 调用 ， 测 试 将 失败 ;对 于 注释 6, getAll Characters 
方法 返回 样 例 列表 ;对 于 注释 7， 在 显示 层 上 调用 一 个 定义 完毕 的 行为 ， 对 于 注释 8， 检 
测 存储 库 返 回 的 列表 是 否 与 所 显示 的 列表 相同 。 

为 了 简化 上 述 定义 ， 可 析 取 出 BaseMarvelRepository 和 BaseMainView， 并 在 独立 类 中 
持 有 样 例 数据 ， 如 下 所 示 : 

// test source set 

package com.sample.marvelgallery.helpers 























import com.sample.marvelgallery.data.MarvelRepository 
import com.sample.marvelgallery.model.MarvelCharacter 
import io.reactivex.Single 


class BaseMarvelRepository( 
val onGetCharacters: () -> Single<List<MarvelCharacter>> 


) : MarvelRepository ( 


override fun getAllCharacters() = onGetCharacters() 
} 


// test source set 
package com.sample.marvelgallery.helpers 


import com.sample.marvelgallery.model.MarvelCharacter 
import com.sample.marvelgallery.view.main.MainView 


class BaseMainView( 
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var onShow: (items: List<MarvelCharacter>) -> Unit = {}, 
val onShowError: (error: Throwable) -> Unit = {}, 
override var refresh: Boolean = false 

) : MainView { 


override fun show(items: List<MarvelCharacter>) { 
onShow (items) 


override fun showError(error: Throwable) { 
onShowError (error) 


// test source set 
package com.sample.marvelgallery.helpers 


import com.sample.marvelgallery.model.MarvelCharacter 


object Example { 
val exampleCharacter = MarvelCharacter 
("ExampleName", "ExampleImageUrl") 
val exampleCharacterList = listof( 
exampleCharacter, 
MarvelCharacter ("Namel", "ImageUrll"), 
MarvelCharacter ("Name2", "ImageUrl2") 


} 
当前 ， 可 简化 PresenterActionAssertion 的 定义 ， 如 下 所 示 : 


package com.sample.marvelgallery 


import com.sample.marvelgallery.helpers.BaseMainView 

import com.sample.marvelgallery.helpers.BaseMarvelRepository 
import com.sample.marvelgallery.helpers.Example 

import com.sample.marvelgallery.model.MarvelCharacter 

import com.sample.marvelgallery.presenter.MainPresenter 
import io.reactivex.Single 

import org.junit.Assert.assertEquals 

import org.junit.Assert.fail 

import org.junit.Test 


@suppress ("IllegalIdentifier") 
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class MainPresenterTest { 


@Test 

fun “After view was created, list of characters is loaded and 
displayed*() { 
assertOnAction { onViewCreated() ).thereIsSameListDisplayed() 


@Test 
fun "New list is shown after view was refreshed*() { 
assertOnAction { onRefresh() }.thereIsSameListDisplayed () 


private fun assertOnAction(action: MainPresenter.() -> Unit) 
= PresenterActionAssertion (action) 


private class PresenterActionAssertion 
(val actionOnPresenter: MainPresenter.() -> Unit) { 


fun thereIsSameListDisplayed() { 
// Given 
var displayedList: List<MarvelCharacter>? = null 


val view = BaseMainView( 
onShow = { items -> displayedList = items }, 
onShowError = { fail() } 


val marvelRepository = BaseMarvelRepository ( 
onGetCharacters = 

{ Single.just (Example.exampleCharacterList) } 

) 


val mainPresenter = MainPresenter(view, marvelRepository) 


// When 
mainPresenter.actionOnPresenter () 


// Then 
assertEquals (Example.exampleCharacterList, displayedList) 
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启动 测试 时 ， 对 应 效果 如 图 9.13 所 示 。 








i= Debug MainPresenterTest 
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FA 9.13 
从 图 9.14 中 可 知 ， 测 试 并 未 通过 。 
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图 9.14 


其 原因 在 于 ， 相 关 功 能 项 并 未 在 MainPresenter 中 了 予以 实现 。 对 此 ， 满 足 单元 测试 的 最 
的 代码 如 下 所 示 : 











package com.sample.marvelgallery.presenter 


import com.sample.marvelgallery.data.MarvelRepository 
import com.sample.marvelgallery.view.main.MainView 


class MainPresenter(val view: MainView, val repository: MarvelRepository) 
t 


fun onViewCreated() ( 
loadCharacters() 


fun onRefresh() ( 
loadCharacters() 


private fun loadCharacters() ( 
repository.getAllCharacters () 
-subscribe(( items -> 
view.show(items) 
H) 
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@ New list is shown after view was retreshe 111ms 
@ After view was created, list of characters is Oms| 








图 9.15 
但 针对 下 列 实现 ， 仍 存在 两 个 问题 : 
































因而 无 法 在 Android 中 正常 工作 。 
e 如 果 用 户 在 加 载 完成 之 前 离开 当前 应 用 程序 ， 将 存在 内 存 泄漏 问题 。 


























e 由 于 getAllCharacters 使 用 了 网 络 操作 ， 且 无 法 像 当 前 示例 中 那样 运行 于 主线 程 上 ， 


e 对 于 第 一 个 问题 ， 需 要 指定 操作 的 具体 线程 。 网 络 线程 应 运行 于 VO 线程 上 ， 同 时 


还 应 在 Android 的 主线 程 上 进行 查看 (由 于 在 回调 中 改变 了 视图 )， 如 下 所 示 : 


repository.getAllCharacters () 
.SubscribeOn(Schedulers.io()) // 1 
.observeOn (AndroidSchedulers.mainThread()) // 2 
.subscribe(( items -> view.show(items) }) 


针对 注释 1， 网 络 线程 应 运行 于 IO 线程 上 ， 对 于 注释 2， 回 调 应 在 主线 程 上 启用 。 
对 于 这 一 类 较为 常见 的 调度 程序 ， 可 将 其 设置 于 顶级 扩展 函数 中 ， 如 下 所 示 : 


// RxExt.kt 
package com.sample.marvelgallery.data 

















import io.reactivex.Single 
import io.reactivex.android.schedulers.AndroidSchedulers 
import io.reactivex.schedulers.Schedulers 


fun «T» Single<T>.applySchedulers(): Single<T> = this 
.subscribeOn (Schedulers.io()) 
-observeOn (AndroidSchedulers.mainThread()) 


And use it in MainPresenter: 
repository.getAllCharacters () 


-applySchedulers () 
.Subscribe(( items -> view.show(items) }) 


测试 不 允许 访问 Android 主线 程 。 因 此 ， 测 试 无 法 通过 。 另 外 ， 运 行 于 新 线程 上 











的 操 





作 并 非 是 单元 测试 中 的 所 需 内 容 ， 这 会 产生 断言 同步 问题 。 当 解决 此 类 问题 时 ， 须 在 单元 
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测试 之 前 履 写 调度 程序 ， 并 使 全 部 内 容 运 行 于 同一 线程 上 〈 将 其 添加 至 Main PresenterTest 


类 中 








Ph)， 如 下 所 示 : 


package com.sample.marvelgallery 


import com.sample.marvelgallery.helpers.BaseMainView 
import com.sample.marvelgallery.helpers.BaseMarvelRepository 
import com.sample.marvelgallery.helpers.Example 

import com.sample.marvelgallery.model.MarvelCharacter 
import com.sample.marvelgallery.presenter.MainPresenter 
import io.reactivex.Single 

import io.reactivex.android.plugins.RxAndroidPlugins 
import io.reactivex.plugins.RxJavaPlugins 

import io.reactivex.schedulers.Schedulers 

import org.junit.Assert.assertEquals 

import org.junit.Assert.fail 

import org.junit.Before 

import org.junit.Test 


@suppress ("IllegalIdentifier") 
class MainPresenterTest { 


@Before 
fun setUp() { 

RxAndroidPlugins.setInitMainThreadSchedulerHandler { 
Schedulers.trampoline() } 

RxJavaPlugins.setloSchedulerHandler { Schedulers.trampoline() } 

RxJavaPlugins.setComputationSchedulerHandler { 
Schedulers.trampoline() } 

RxJavaPlugins.setNewThreadSchedulerHandler { 
Schedulers.trampoline() } 


@Test 

fun “After view was created, list of characters is loaded and 
displayed*() { 
assertOnAction { onViewCreated() }.thereIsSameListDisplayed() 


@Test 
fun "New list is shown after view was refreshed*() { 
assertOnAction { onRefresh() ).thereIsSameListDisplayed() 
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如 图 9.16 所 示 ， 测 试 再 次 通过 。 








@ New list is shown after view was refreshe 111ms 
@ After view was created, list of characters is Om: 





E 9.16 
另 一 个 问题 则 是 内 存 泄 漏 , 也 就 是 说 , 用 户 在 获取 服务 器 响应 之 前 离开 当前 应 用 程序 。 
一 类 常见 的 方法 是 ， 当 用 户 离开 应 用 程序 时 , 使 全 部 订阅 处 于 复合 状态 , 并 对 其 进行 处 理 ， 
如 下 所 示 : 


private var subscriptions = CompositeDisposable() 





























fun onViewDestroyed() ( 

subscriptions.dispose() 

} 

在 较 大 的 应 用 程序 项 目 中 , 大 多 数 显示 层 均 包含 一 些 订阅 服务 。 因 此 , 收集 订阅 服务 ， 
以 及 当 用 户 销毁 视图 时 的 处 理 行为 均 可 视 作 一 种 常见 行为 ， 并 可 从 BasePresenter 中 获取 。 
除 此 之 外 ， 为 了 简化 操作 过 程 ， 还 可 定义 BaseActivityWithPresenter 类 ， 以 加 载 Presenter 
接口 背后 的 显示 层 ， 进 而 在 视图 被 销毁 时 调用 onViewDestroyed 方法 。 下 面 在 应 用 程序 中 
实现 这 一 机 制 ，Presenter 的 定义 如 下 所 示 : 


package com.sample.marvelgallery.presenter 












































interface Presenter { 
fun onViewDestroyed() 
} 


BasePresenter 的 定义 如 下 所 示 : 


package com.sample.marvelgallery.presenter 
import io.reactivex.disposables.CompositeDisposable 
abstract class BasePresenter : Presenter { 
protected var subscriptions = CompositeDisposable() 
override fun onViewDestroyed() { 


subscriptions.dispose() 
} 
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BaseActivityWithPresenter 的 定义 如 下 所 示 : 
package com.sample.marvelgallery.view.common 


import android.support.v7.app.AppCompatActivity 
import com.sample.marvelgallery.presenter.Presenter 


abstract class BaseActivityWithPresenter : AppCompatActivity() ( 
abstract val presenter: Presenter 


override fun onDestroy() ( 
super.onDestroy() 
presenter.onViewDestroyed() 


} 
为 了 简化 订阅 服务 的 添加 操作 ， 可 定义 一 个 plusAssgin 操作 符 ， 如 下 所 示 : 


// RxExt.ext 
package com.sample.marvelgallery.data 


import io.reactivex.Single 

import io.reactivex.android.schedulers.AndroidSchedulers 
import io.reactivex.disposables.CompositeDisposable 
import io.reactivex.disposables.Disposable 

import io.reactivex.schedulers.Schedulers 


fun «T» Single<T>.applySchedulers(): Single<T> = this 
.subscribeOn (Schedulers.io()) 
. observeOn (AndroidSchedulers.mainThread()) 


operator fun CompositeDisposable.plusAssign (disposable: Disposable) { 
add (disposable) 
) 


根据 上 述 内 容 ， 可 确保 MainPresenter 处 于 安全 状态 ， 如 下 所 示 : 


package com.sample.marvelgallery.presenter 





import com.sample.marvelgallery.data.MarvelRepository 
import com.sample.marvelgallery.data.applySchedulers 
import com.sample.marvelgallery.data.plusAssign 
import com.sample.marvelgallery.view.main.MainView 
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class MainPresenter( 

val view: MainView, 

val repository: MarvelRepository 
) : BasePresenter() ( 


fun onViewCreated() ( 
loadCharacters () 


fun onRefresh() { 
loadCharacters () 


private fun loadCharacters() { 
subscriptions += repository.getAllCharacters () 
-applySchedulers () 
.subscribe(( items -> 
view.show (items) 
) 


) 


其 中 ， 前 两 个 MainPresenter 行为 均 已 实现 ， 当 API 返回 一 条 错误 消息 时 ， 对 应 内 容 将 显 
示 于 视图 上 ， 此 处 可 将 这 一 条 件 作为 一 项 测试 添加 至 MainPresenterTest 中 ， 如 下 所 示 : 


@Test 
fun "New list is shown after view was refreshed*() { 
assertOnAction { onRefresh() ).thereIsSameListDisplayed() 


@Test 
fun ‘When API returns error, it is displayed on view*() { 
// Given 
val someError = Error() 
var errorDisplayed: Throwable? = null 
val view = BaseMainView ( 
onShow = { -» fail() }, 
onShowError = ( errorDisplayed = it } 
) 
val marvelRepository = BaseMarvelRepository 
{ Single.error(someError) } 
val mainPresenter = MainPresenter(view, marvelRepository) 
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// When 

mainPresenter.onViewCreated() 

// Then 

assertEquals (someError, errorDisplayed) 


private fun assertOnAction(action: MainPresenter.() -» Unit) 
= PresenterActionAssertion (action) 
稍 作 变 化 即 可 使 该 测试 通过 ， 即 MainPresenter 的 subscribe 方法 中 的 错误 处 理 程序 规 
范 ， 如 下 所 示 : 
subscriptions += repository.getAllCharacters() 
-applySchedulers () 
.subscribe(( items -> // onNext 
view.show (items) 
}, ( // onError 
view.showError (it) 





}) 
虽然 subscribe 是 Java 中 的 方法 ， 但 我 们 无 法 使 用 命名 参数 规则 。 此 类 调用 并 非 真 正 
具备 描述 性 特征 ， 这 也 是 在 RxExtkt 中 设置 名 为 subscribeBy 的 自 定义 方法 的 原因 ， 如 下 
ARAN: 
// Ext.kt 


fun «T» Single<T>.applySchedulers(): Single<T> = this 
. subscribeOn (Schedulers.io()) 
-observeOn (AndroidSchedulers.mainThread() ) 
fun <T> Single<T>.subscribeBy ( 
onError: ((Throwable) -» Unit)? = null, 
onSuccess: (T) -» Unit 
): Disposable = subscribe(onSuccess, ( onError?.invoke(it) }) 


因而 此 处 将 不 再 使 用 订阅 服务 ， 实 际 操作 如 下 所 示 : 


subscriptions += repository.getAllCharacters() 
-applySchedulers () 
. subscribeBy ( 
onSuccess = view::show, 
onError = view::showError 
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针对 不 同 RxJava 类 型 所 定义 的 完整 版 本 的 subscribeBy ( Observable、 
qp Flowable 等 ), 以 及 面向 RxJava t 3-467 3k Kotlin 扩展 位 于 RxKotlin 库 中 ( 对 
应 网 址 为 https://github.com/ReactiveX/RxKotlin )。 


当 显 示 或 隐藏 加 载 过 程 时 ， 可 对 出 现 于 处 理 前 /后 的 事件 定义 额外 的 监听 器 ， 如 下 
所 示 : 


subscriptions += repository.getAllCharacters() 
-applySchedulers () 
.doonSubscribe { view.refresh = true },} 
onSuccess = view::show, 
-doFinally { view.refresh = false } 
.subscribeBy( 
onSuccess - view::show, 
onError = view:: 
onFinish = ( view.refresh = false } 











) 
随后 ， 测 试 再 次 通过 ， 如 图 9.17 所 示 。 


BELE +t oes 
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@ When API returns error, it is displayed on v 74m« 
@ New list is shown after view was refreshec 24ms 
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El 9.17 
当前 , subscribe 方法 的 可 读 性 变 得 越 来 越 差 , 但 可 协同 另 一 个 商业 逻辑 处 理 此 类 问题 ， 
其 定义 可 描述 为 : 当 显 示 层 迭代 某 个 响应 时 , 刷新 将 被 显示 。 下列 代码 在 Main PresenterTest 
Ph 定 义 了 单元 测试 。 


package com.sample.marvelgallery 


n 





import com.sample.marvelgallery.helpers.BaseMainView 

import com.sample.marvelgallery.helpers.BaseMarvelRepository 
import com.sample.marvelgallery.helpers.Example 

import com.sample.marvelgallery.model.MarvelCharacter 

import com.sample.marvelgallery.presenter.MainPresenter 
import io.reactivex.Single 

import io.reactivex.android.plugins.RxAndroidPlugins 

import io.reactivex.plugins.RxJavaPlugins 

import io.reactivex.schedulers.Schedulers 
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import org.junit.Assert.* 
import org.junit.Before 
import org.junit.Test 


@suppress ("IllegalIdentifier") 
class MainPresenterTest ( 


@Test 
fun "When presenter is waiting for response, refresh is displayed'() 
t 
// Given 
val view - BaseMainView(refresh - false) 
val marvelRepository - BaseMarvelRepository( 
onGetCharacters = { 
Single.fromCallable { 
// Then 
assertTrue(view.refresh) // 1 
Example .exampleCharacterList 


) 
val mainPresenter = MainPresenter(view, marvelRepository) 
view.onShow = { -> 
// Then 
assertTrue (view.refresh) // 1 
// When 
mainPresenter.onViewCreated() 
// Then 
assertFalse(view.refresh) // 1 


) 
对 于 注释 1， 和 希望 在 网 络 请 求 过 程 中 以 及 显示 元 素 时 显示 刷新 ， 而 非 处 理 结束 之 后 。 





在 RxJava2 上 的 版 本 中 ,回调 中 的 断言 并 未 中 断 测试 , 但 却 在 执行 报告 
中 显示 了 一 条 错误 消息 ， 如 图 9.18 和 图 9.19 所 示 。 
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at io.reactivex.Single.subscribe(S à ) 
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at io. raactivex. internal. schedulers. TrampoLineScheduler. scheduleDirect (ron uler j ) 
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图 9.19 


© 在 未 来 版 本 中 , 可 能 会 加 入 一 个 处 理 程序 , 并 可 从 回调 内 部 中 断 某 个 
测试 


当 显 示 或 隐藏 加 载 过 程 时 , 可 对 出 现 于 处 理 前 /后 的 事件 定义 额外 的 监听 器 , 如 下 所 示 : 


subscriptions += repository.getAllCharacters() 
-applySchedulers () 
.doOnSubscribe { view.refresh = true } 
-doFinally { view.refresh = false } 
. subscribeBy ( 
onSuccess = view::show, 
onError = view: :showError 


) 
有 双 历 了 上 述 全 部 调整 后 ， 全 部 测试 均 可 再 次 通过 ， 如 图 9.20 所 示 。 


Oop oes 
Piao jre/bin/java ... 
@ When API returns error, itis displayed on v 97m: 
@ When presenter is waiting for response, re 23m 
@ New list is shown after view was refreshed lm 
@ After view was created, list of characters is. Im: 














All 4 tests passed - 122ms 








Process finished with exit code 9 








图 9.20 


至 此 ， 我 们 得 到 了 完整 的 功能 显示 层 、 网 络 以 及 视图 ， 可 将 其 进行 适当 整合 并 完成 第 
一 个 用 例 。 


4. 整合 


目前 , 项 目 中 的 MainPresenter 已 准备 完毕 ， 并 可 在 MainActivity 中 对 其 加 以 使 用 ， 如 
下 所 示 : 
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e com.sample.marvelgallery.view.main 


android.os.Bundle 
android.support.v7.widget.GridLayoutManager 
android.view.Window 

com.sample.marvelgallery.R 
com.sample.marvelgallery.data.MarvelRepository 
com.sample.marvelgallery.model.MarvelCharacter 
com.sample.marvelgallery.presenter.MainPresenter 
com.sample.marvelgallery.view.common.BaseActivityWithPresenter 
com.sample.marvelgallery.view.common.bindToSwipeRefresh 
com.sample.marvelgallery.view.common.toast 
kotlinx.android.synthetic.main.activity main.* 


MainActivity : BaseActivityWithPresenter(), MainView ( // 1 
rride var refresh by bindToSwipeRefresh (R.id.swipeRefreshView) 


2 
rride val presenter by lazy 


( MainPresenter(this, MarvelRepository.get()) ) // 3 


ove 


over 


over 


rride fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate (savedInstanceState) 

requestWindowFeature (Window.FEATURE NO TITLE) 
setContentView(R.layout.activity main) 
recyclerView.layoutManager - GridLayoutManager(this, 2) 
swipeRefreshView. setOnRefreshListener 

{ presenter.onRefresh() } // 4 
presenter.onViewCreated() // 4 


ride fun show(items: List<MarvelCharacter>) { 
val categoryItemAdapters = items.map(::CharacterItemAdapter) 
recyclerView.adapter = MainListAdapter (categoryItemAdapters) 


ride fun showError(error: Throwable) { 
toast ("Error: ${error.message}") // 2 
error.printStackTrace () 
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对 于 注释 1，Activity 应 扩展 BaseActivityWithPresenter 并 实现 MainView; 对 于 注释 2, 
bindToSwipeRefresh 和 toast 尚未 实现 ; 对 于 注释 3， 此 处 通过 延迟 方式 定义 显示 层 。 其 中 ， 


第 一 个 参数 表示 为 指向 MainView 接口 之 后 的 Activity 的 引用 ; 对 于 注释 4， 须 通过 其 方法 
向 显示 层 传递 事件 。 



































在 上 述 代码 中 , 使 用 了 之 前 已 经 讨论 的 两 个 函数 ,toast (用 于 显示 屏幕 上 的 烤 面包 ) 






































和 bindToSwipeRefresh( 用 于 将 属性 与 划 动 手势 的 可 见 性 进行 绑 定 ), 对 应 内 容 如 下 所 示 : 


// NiewExt.kt 
package com.sample.marvelgallery.view.common 


import android.app.Activity 

import android.content.Context 

import android.support.annotation.IdRes 
import android.support.v4.widget.SwipeRefreshLayout 
import android.support.v7.widget.RecyclerView 
import android.view.View 

import android.widget.ImageView 

import android.widget.Toast 

import com.bumptech.glide.Glide 

import kotlin.properties.ReadWriteProperty 
import kotlin.reflect.KProperty 


fun «T : View» RecyclerView.ViewHolder.bindView(viewId: Int) 
= lazy { itemView.findViewById«T» (viewId) } 


fun ImageView.loadImage (photoUrl: String) { 
Glide.with (context) 
. load (photoUrl) 
.into (this) 


fun Context.toast (text: String, length: Int = Toast.LENGTH LONG) { 
Toast.makeText (this, text, length) .show() 
} 


fun Activity.bindToSwipeRefresh (@IdRes swipeRefreshLayoutId: Int): 
ReadWriteProperty<Any?, Boolean> 

= SwipeRefreshBinding(lazy { 
findViewById«SwipeRefreshLayout» (swipeRefreshLayoutId) }) 


private class SwipeRefreshBinding (lazyViewProvider: 
Lazy<SwipeRefreshLayout>) : ReadWriteProperty«Any?, Boolean» { 
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val view by lazyViewProvider 


override fun getValue(thisRef: Any?, 

property: KProperty<*>): Boolean { 
return view.isRefreshing 

} 


override fun setValue(thisRef: Any?, 
property: KProperty<*>, value: Boolean) { 
view.isRefreshing = value 
) 
) 


图 9.21 显示 了 正确 的 人 物 角色 列表 。 
a 


Marvel Gallery 


Absorbing 


Adam 


masDestine 











Data provided by Marvel. © 2017 MARVEL 








图 9.21 


至 此 ， 第 一 个 用 例 讨 论 完 毕 ， 下 面 讨论 人 物 角 色 搜索 问题 。 
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9.1.4 ”人物 角色 搜索 


另 一 个 需要 实现 的 操作 是 人 物 角色 的 搜索 功能 , 该 | 























户 可 根据 名 称 搜索 某 个 人 物 角 色 。 
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例 可 描述 为 : 在 启动 应 月 





当 添 加 此 项 功能 时 ， 可 向 activity_main 布局 中 添加 EditText， 如 下 所 示 : 


«?xml version-"1.0" encoding="utf-8"?> 
<RelativeLayout 


xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:app-"http://schemas.android.com/apk/res-auto" 
xmlns:tools-"http://schemas.android.com/tools" 





android: id="@+id/charactersView" 
android:layout width="match parent" 
android:layout height="match parent" 


android:background="@android:color/white" 


android: fitsSystemWindows="true"> 


<!-- Dummy item to prevent EditText from receiving 


focus on initial load --> 
<LinearLayout 
android: layout width="0px" 
android: layout height="0px" 
android: focusable="true" 


android: focusableInTouchMode="true" 


tools: ignore="UselessLeaf" /> 


<android.support.design.widget . TextInputLayout 


android: id="@+id/searchViewLayout" 
android: layout width-"match parent" 
android: layout height="wrap content" 


android:layout margin="@dimen/element padding"> 


<EditText 
android: id="@+id/searchView" 


android:layout width="match parent" 


android:layout height="wrap content" 

android:layout centerHorizontal="true" 

android:hint="@string/search hint" /> 
</android. support .design.widget .TextInputLayout> 


<android. support .v4.widget .SwipeRefreshLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 


HFE 








序 后 ， 
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android: id="@+id/swipeRefreshView" 

android:layout width="match parent" 

android:layout height-"match parent" 

android:layout below="@+id/searchViewLayout" 

app:layout behavior="@string/appbar scrolling view behavior"> 


«android.support.v7.widget.RecyclerView 
android: id="@+id/recyclerView" 
android:layout width="match parent" 
android:layout height-"match parent" 
android:scrollbars-"vertical" /» 

«/android.support.v4.widget.SwipeRefreshLayout» 





«TextView 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:layout alignParentBottom-"true" 
android:background-"Gandroid:color/white" 
android:gravity-"center" 
android:text="@string/marvel copyright notice" /> 





«/RelativeLayout» 
另外 ， 还 须 添加 Android 兼容 库 依赖 项 ， 进 而 可 使 用 TextInputLayout， 如 下 所 示 : 
implementation 


"com.android.support:appcompat-v7:$android support version" 
implementation "com.android.support:design:$android support version" 
implementation "com.android.support:recyclerview 

v7:$android support version" 


strings.xml 文件 中 的 search. hint 字符 串 定义 如 下 所 示 ; 


«resources» 
«string name-"app name">MarvelGallery</string> 
«string name-"search hint">Search for character</string> 
«string name-"marvel copyright notice"» 
Data provided by Marvel. . 2017 MARVEL 
«/string» 
</resources> 


除 此 之 外 ， 还 须 设置 相关 标签 ， 并 在 开启 键盘 时 显示 Marvel 版 权 信息 ， 同 时 ， 还 须 
在 AndroidManifest 中 自动 调整 activity 定义 中 的 windowSoftInputMode， 如 下 所 示 : 


























<activity 
android:name="com.sample.marvelgallery.view.main.MainActivity" 


+ 350% 
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android:windowSoftInputMode-"adjustResize"» 


<intent-filter> 


«action android:name-"android.intent.action.MAIN" 


/> 


«category android:name-"android.intent.category.LAUNCHER" /> 


</intent-filter> 
</activity> 
对 应 结果 如 图 9.22 所 示 。 
下 面 可 将 搜索 











添加 至 MainActivity 中 ， 如 图 9.23 所 示 。 
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图 9.22 
此 处 所 期 望 的 行为 可 描述 为 : 
onSearchChanged， 相 关内 容 如 下 所 示 : 


fun onRefresh() ( 
loadCharacters() 


fun onSearchChanged(text: String) 
// TODO 


private fun loadCharacters() { 


{ 


图 9.23 


当 用 户 修改 搜索 栏 中 的 文本 时 ， 将 加 载 一 个 新 列表 。 对 
JE, WE MainPresenter 中 定义 一 个 新 方法 ， 用 于 通知 显示 层 文 本 方式 变化 。 该 方法 称 作 


subscriptions += repository.getAllCharacters() 


-applySchedulers () 
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-doOnSubscribe ( view.refresh = true } 
.doFinally ( view.refresh - false ] 
-subscribeBy( 

onSuccess - view::show, 


onError = view::showError 


) 


此 处 需要 修改 MarvelRepository 定义 ， 并 作为 getAllCharacters 参数 接收 一 个 搜索 查询 〈 需 
要 注意 的 是 ， 还 须 更 新 BaseMarvelRepository)， 如 下 所 示 : 


interface MarvelRepository ( 


fun getAllCharacters (searchQuery: String?): 
Single<List<MarvelCharacter>> 


companion object : Provider<MarvelRepository>() { 
override fun creator() = MarvelRepositoryImpl() 


} 
最 后 ， 更 新 后 的 实现 过 程 如 下 所 示 : 


class MarvelRepositoryImpl : MarvelRepository { 





val api = retrofit.create (MarvelApi::class.java) 


override fun getAllCharacters(searchQuery: String?) : 
Single<List<MarvelCharacter>> = api.getCharacters ( 
offset = 0, 
searchQuery = searchQuery, 
limit = elementsOnListLimit 


).map { it.data?.results.orEmpty().map(::MarvelCharacter) ?: 
emptyList() ) 


companion object ( 
const val elementsOnListLimit = 50 


) 
另外 ， 还 须 更 新 网 络 请 求 定义 ， 如 下 所 示 ; 


interface MarvelApi ( 
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@GET ("characters") 
fun getCharacters( 
@Query ("offset") offset: Int?, 
GQuery("nameStartsWith") searchQuery: String?, 
GQuery("limit") limit: Int? 
): Single<DataWrapper<List<CharacterMarvelDto>>> 
} 


为 了 对 代码 进行 编译 ， 应 提供 null fE73 MainPresenter 中 的 getAllCharacters 参数 ， 如 
下 所 示 : 
private fun loadCharacters() { 
subscriptions += repository.getAllCharacters (null) 
-applySchedulers () 
.doOnSubscribe { view.refresh = true } 
-doFinally { view.refresh = false } 
. subscribeBy ( 
onSuccess = view::show, 
onError = view::showError 


} 
同时 ， 还 须 更 新 BaseMarvelRepository, W Fr: 
package com.sample.marvelgallery.helpers 
import com.sample.marvelgallery.data.MarvelRepository 


import com.sample.marvelgallery.model.MarvelCharacter 
import io.reactivex.Single 


class BaseMarvelRepository( 


val onGetCharacters: (String?) -> Single<List<MarvelCharacter>> 
) : MarvelRepository ( 


override fun getAllCharacters (searchQuery: String?) 
= onGetCharacters (searchQuery) 
} 


当前 ， 网 络 实现 将 返回 一 个 源 自 查询 的 人 物 角 色 列 表 ; 或 者 ， 若 未 指定 查询 ， 则 返 
一 个 填充 列表 。 对 此 ， 可 首先 定义 显示 层 ， 下 面 定义 相关 测试 : 


Gfile:Suppress ("IllegalIdentifier") 























Pl 




















package com.sample.marvelgallery 
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import com.sample.marvelgallery.helpers.BaseMainView 

import com.sample.marvelgallery.helpers.BaseMarvelRepository 
import com.sample.marvelgallery.presenter.MainPresenter 
import io.reactivex.Single 

import org.junit.Assert.* 

import org.junit.Test 


class MainPresenterSearchTest ( 
@Test 
fun "When view is created, then search query is null'() { 
assertOnAction ( onViewCreated() ) searchQueryIsEqualTo null 


@Test 
fun "When text is changed, then we are searching for new query'() { 
for (text in listOf("KKO", "HJ HJ", "And so what?")) 
assertOnAction ( onSearchChanged(text) } 
SearchQueryIsEqualTo text 


private fun assertOnAction(action: MainPresenter.() -> Unit) 
= PresenterActionAssertion (action) 


private class PresenterActionAssertion(val actionOnPresenter: 
MainPresenter.() -» Unit) ( 


infix fun searchQueryIsEqualTo(expectedQuery: String?) { 

var checkApplied - false 

val view = BaseMainView(onShowError = ( fail() }) 

val marvelRepository = BaseMarvelRepository ( searchQuery -> 
assertEquals (expectedQuery, searchQuery) 
checkApplied = true 
Single.never () 

} 

val mainPresenter = MainPresenter (view, marvelRepository) 

mainPresenter.actionOnPresenter () 

assertTrue (checkApplied) 


) 
为 了 使 测试 通过 ， 需 要 添加 搜索 查询 ， 并 作为 参数 〈 默 认 参 数 ) 向 MainPresenter 的 
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loadCharacters 方法 添加 搜索 查询 ， 如 下 所 示 : 


fun onSearchChanged(text: String) ( 
loadCharacters (text) 


private fun loadCharacters (searchQuery: String? = null) { 
subscriptions += repository.getAllCharacters (searchQuery) 
.applySchedulers() 
-doOnSubscribe { view.refresh = true } 
-doFinally { view.refresh = false } 


. subscribeBy ( 
onSuccess = view::show, 
onError = view: :showError 


) 

这 里 的 问题 在 于 ，Marvel API 不 允许 空格 作为 搜索 查询 内 容 ， 此 时 将 会 发 送 null. K 
此 ， 如 果 用 户 删 除了 最 后 一 个 字符 ， 或 者 试图 在 搜索 栏 中 查找 空格 ， 程 序 将 会 月 溃 ， 应 防 
止 此 类 情况 出 现 。 下 列 测试 将 检查 显示 层 是 否 将 仅 包含 空格 键 的 查询 转换 为 nullo 





@Test 
fun "When text is changed, then we are searching for new query' () { 


for (text in listOf("KKO", "HJ HJ", "And so what?") 
assertOnAction ( onSearchChanged(text) } 
searchQueryIsEqualTo text 


@Test 
fun ‘For blank text, there is request with null query' () { 
tor (empEyText in Lieto mom um m)y 
assertOnAction ( onSearchChanged(emptyText) } 
searchQueryIsEqualTo null 


private fun assertOnAction(action: MainPresenter.() -> Unit) 
— PresenterActionAssertion (action) 


在 loadCharacters 方法 中 ， 可 实现 一 种 安全 监测 机 制 ， 如 下 所 示 : 


private fun loadCharacters (searchQuery: String? = null) ( 
val qualifiedSearchQuery = if (searchQuery.isNullOrBlank()) null 
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else searchQuery 
subscriptions += repository 
-getAllCharacters (qualifiedSearchQuery) 
-applySchedulers () 
-smartSubscribe( 
onStart = ( view.refresh = true ], 
onSuccess = view::show, 
onError = view::showError, 
onFinish = { view.refresh = false } 


} 
当前 ， 全 部 测试 均 已 通过 ， 如 图 9.24 所 示 。 
OPIJA 





v @ MainPresenterSearchTest 104ms 
@ For blank text, there is request with nul 53m: 
@ After start, there is request for with null Oms 
@ When text is changed, then we are seai 21m: 
Y MainPresenterTest lims| 
@ When AP! returns error, it is displayed o 7m: 
@ When presenter is waiting for response, 2ms 
@ New list is shown after view was refresl 2ms 
@ After view was created, list of character Oms 





图 9.24 
除 此 之 外 ， 还 须 实现 Activity 功能 ， 并 在 文本 变化 时 调用 显示 层 。 对 此 ， 可 使 用 第 7 
章 讨 论 的 回调 类 (可 选 )， 如 下 所 示 : 
// TextChangedListener.kt 


package com.sample.marvelgallery.view.common 


import android.text.Editable 
import android.text.TextWatcher 
import android.widget.TextView 


fun TextView.addOnTextChangedListener(config: TextWatcherConfiguration. () 


-» Unit) ( 
addTextChangedListener(TextWatcherConfiguration().apply ( config() } 


addTextChangedListener (textWatcher) 


class TextWatcherConfiguration : TextWatcher { 


private var beforeTextChangedCallback: 
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(BeforeTextChangedFunction)? = null 
private var onTextChangedCallback: 
(OnTextChangedFunction)? = null 
private var afterTextChangedCallback: 
(AfterTextChangedFunction)? = null 


fun beforeTextChanged(callback: BeforeTextChangedFunction) 
beforeTextChangedCallback = callback 


fun onTextChanged (callback: OnTextChangedFunction) { 
onTextChangedCallback = callback 


fun afterTextChanged(callback: AfterTextChangedFunction) ( 
afterTextChangedCallback - callback 


override fun beforeTextChanged(s: CharSequence, 

start: Int, count: Int, after: Int) ( 
beforeTextChangedCallback?.invoke (s.toString(), 
start, count, after) 


override fun onTextChanged(s: CharSequence, start: Int, 
before: Int, count: Int) { 
onTextChangedCallback?.invoke (s.toString(), 
start, before, count) 


override fun afterTextChanged(s: Editable) ( 
afterTextChangedCallback?.invoke (s) 


private typealias BeforeTextChangedFunction = 

(text: String, start: Int, count: Int, after: Int) -» Unit 
private typealias OnTextChangedFunction = 

(text: String, start: Int, before: Int, count: Int) -> Unit 
private typealias AfterTextChangedFunction = 

(s: Editable) -» Unit 


下 列 代码 显示 了 MainActivity 的 onCreate 方法 中 的 应 用 过 程 。 
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package com.sample.marvelgallery.view.main 


import android.os.Bundle 

import android.support.v7.widget.GridLayoutManager 

import android.view.Window 

import com.sample.marvelgallery.R 

import com.sample.marvelgallery.data.MarvelRepository 

import com.sample.marvelgallery.model.MarvelCharacter 

import com.sample.marvelgallery.presenter.MainPresenter 

import com.sample.marvelgallery.view.common.BaseActivityWithPresenter 
import com.sample.marvelgallery.view.common.addOnTextChangedListener 
import com.sample.marvelgallery.view.common.bindToSwipeRefresh 
import com.sample.marvelgallery.view.common.toast 

import kotlinx.android.synthetic.main.activity main.* 


class MainActivity : BaseActivityWithPresenter(), MainView ( 


override var refresh by bindToSwipeRefresh (R.id.swipeRefreshView) 
override val presenter by lazy 
( MainPresenter(this, MarvelRepository.get()) } 


override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate (savedInstanceState) 
requestWindowFeature (Window.FEATURE NO TITLE) 
setContentView(R.layout.activity main) 
recyclerView.layoutManager - GridLayoutManager(this, 2) 
swipeRefreshView.setOnRefreshListener { presenter.onRefresh() } 
searchView.addOnTextChangedListener { 
onTextChanged { text, , , -> 
presenter .onSearchChanged (text) 


} 


presenter.onViewCreated () 


override fun show(items: List<MarvelCharacter>) { 
val categoryItemAdapters = items.map(::CharacterItemAdapter) 
recyclerView.adapter = MainListAdapter (categoryItemAdapters 


override fun showError(error: Throwable) { 
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toast("Error: ${error.message}") 
error.printStackTrace() 


} 


至 此 , 人物 角 色 的 搜索 功能 全 部 结束 , 读者 可 构建 该 应 
序 ， 并 以 此 搜索 喜爱 的 人 物 角 色 ， 如 图 925 所 示 。 
下 面 将 讨论 角色 资料 的 显示 问题 。 


9.1.5 “人物 角 色 的 资料 显示 


除了 人 物 角色 搜索 之 外 , 为 了 使 应 用 程序 功能 更 加 丰富 , 还 
应 添加 信物 角色 的 描述 显示 功能 。 也 就 是 说 , 当 用 户 单 击 某 一 人 Y 
物 角 色 的 图 像 时 ， 须 显示 其 背景 资料 ， 其 中 包括 角色 的 名 称 、 相 (sna 
片 、 描 述 及 其 出 现 次 数 。 ALARA | 

当 实 现 这 一 用 例 时 ， 需 要 生成 新 的 Activity 和 布局 ， 并 定义 
Activity 的 外 观 。 对 此 , 可 在 com.sample. marvelgallery.view.character 
包 中 创建 名 为 Character ProfileActivity 的 新 Activity, 如 图 9.26 所 示 。 

下 面 首先 从 布局 变化 (位 于 activity character. profile.xml H) 开始 讨论 。 图 9.27 显示 
了 最 终 的 效果 。 
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3593: Marvel Gallery 项 目 实战 *339* 














其 中 , 基本 元 素 则 是 包含 AppBar 和 CollapsingToolbarLayout 的 CoordinatorLayout, 上 
以 实现 素材 设计 中 所 指 的 收缩 效果 ， 如 图 9.28 所 示 。 
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图 9.28 


另外 , 还 须 针 对 描述 和 出 现 次 数 定义 TextView, 并 通过 下 一 个 用 例 中 的 数据 进行 填充 。 
activity character profile 布局 的 完整 定义 如 下 所 示 : 


<?xml version-"1.0" encoding-"utf-8"?» 

«android.support.design.widget.CoordinatorLayout 

xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:app-"http://schemas.android.com/apk/res-auto" 
xmlns:tools-"http://schemas.android.com/tools" 
android:id-"G«id/character detail layout" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:background-"Gandroid:color/white"» 




















«android.support.design.widget.AppBarLayout 
android: id="@+id/appBarLayout" 
android:layout width="match parent" 
android:layout height="wrap content" 
android: theme="@style/ThemeOverlay .AppCompat .ActionBar"> 


<android. support .design.widget .CollapsingToolbarLayout 
android: id="@+id/toolbarLayout" 
android:layout width="match parent" 
android:layout height="match parent" 
app:contentScrim-"?attr/colorPrimary" 
app:expandedTitleTextAppearance-"(style/ItemTitleName" 
app:layout scrollFlags-"scroll|exitUntilCollapsed"» 
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<android.support.v7-widget.AppCompatImageView 
android: id="@+id/headerView" 
android:layout width="match parent" 





android:layout height="@dimen/character header height" 


android:background="@color/colorPrimaryDark" 
app:layout collapseMode-"parallax" /> 


«android.support.v7.widget.Toolbar 
android: id="@+id/toolbar" 
android:layout width="match parent" 
android:layout height="?attr/actionBarSize" 
android: background="@android:color/transparent" 
app:layout collapseMode="pin" 
app : popupTheme="@style/ThemeOverlay.AppCompat . Light" 


</android. support .design.widget .CollapsingToolbarLayout> 


</android. support .design.widget .AppBarLayout> 


<android.support.v4.widget .NestedScrollView 


android:layout width="match parent" 

android:layout height="match parent" 

android: overScrol1Mode="never" 

app:layout behavior="@string/appbar scrolling view behavior"> 


<LinearLayout 


android:id="@+id/details content frame" 
android:layout width="match parent" 
android: layout height-"match parent" 
android: focusableInTouchMode="true" 
android:orientation="vertical"> 


<TextView 
android: id="@+id/descriptionView" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:gravity-"center" 
android:padding="@dimen/character description padding" 
android:textSize-"8dimen/standard text size" 
tools:text-"This is some long text that will be visible 


an character description." /» 


<TextView 
android: id="@+id/occurrencesView" 
android:layout width="match parent" 
android:layout height-"wrap content" 


/> 


as 
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android:padding="@dimen/character description padding" 
android:textSize-"G8dimen/standard text size" 
tools:text-"He was in following comics:\n* KOKOKO \n* KOKOKO 
\n* KOKOKO \n* KOKOKO \n* KOKOKO \n* KOKOKO \n* KOKOKO \n* KOKOKO \n* 
KOKOKO \n* KOKOKO \n* KOKOKO " /> 
</LinearLayout> 


</android. support .v4.widget .NestedScrollView> 


<TextView 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout gravity="bottom" 
android: background="@android:color/white" 
android: gravity="bottom| center" 
android:text="@string/marvel copyright notice" /> 


<ProgressBar 
android: id="@+id/progressView" 
style-"?android:attr/progressBarStyleLarge" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout gravity-"center" 
android:visibility-"gone" /» 


«/android.support.design.widget.CoordinatorLayout» 





同时 ， 还 需要 向 styles.xml 中 添加 下 列 样式 : 
«resources» 
«!-- Base application theme. --> 


<style name-"AppTheme" 
parent="Theme .AppCompat . Light . DarkActionBar"> 
<!-- Customize your theme here. --> 
<item name="colorPrimary">@color/colorPrimary</item> 
<item name="colorPrimaryDark">@color/colorPrimaryDark</item> 
<item name="colorAccent">@color/colorAccent</item> 
</style> 
<style name-"AppFullScreenTheme" 
parent="Theme .AppCompat . Light .NoActionBar"> 
<item name="android:windowNoTitle">true</item> 
<item name="android:windowActionBar">false</item> 
<item name="android:windowFullscreen">true</item> 
<item name="android:windowContentOverlay">@null</item> 
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«/style» 
«style name-"ItemTitleName" 
parent-"TextAppearance.AppCompat.Headline"» 
<item name="android:textColor">@android:color/white</item> 
<item name="android: shadowColor">@color/colorPrimaryDark</item> 
<item name="android: shadowRadius">3.0</item> 
</style> 
<style name="ItemDetailTitle" 
parent="@style/TextAppearance.AppCompat .Smal1"> 
<item name="android:textColor">@color/colorAccent</item> 
</style> 
</resources> 


此 外 ， 针 对 AndroidManifest 中 的 CharacterProfileActivity, Xi X AppFullScreen 
Theme 作为 主题 ， 如 下 所 示 : 


«activity android:name-".view.CharacterProfileActivity" 
android: theme="@style/AppFullScreenTheme" /> 


图 9.29 显示 了 定义 完毕 后 的 布局 效果 。 


Marvel Gallery 





This is some long text that will be visible 
as an character description 


He was in following comics: 
* KOKOKO 
* KOKOKO 
* KOKOKO 
* KOKOKO 
* KOKOKO 
* KOKOKO 
* KOKOKO 
* KOKOKO 








图 9.29 
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该 视图 用 于 显示 与 人 物 角 色相 关 的 数据 ， 首 先 需要 从 MainActivity 上 
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CharacterItemA dapter 中 的 onClickListener， 这 将 调用 构造 函数 提供 的 clicked 回调 ， 如 下 所 示 ; 


package com.sample.marvelgallery.view.main 


import android.support.v7.widget.RecyclerView 

import android.view.View 

import android.widget.ImageView 

import android.widget.TextView 

import com.sample.marvelgallery.R 

import com.sample.marvelgallery.model.MarvelCharacter 
import com.sample.marvelgallery.view.common.ItemAdapter 
import com.sample.marvelgallery.view.common.bindView 
import com.sample.marvelgallery.view.common.loadImage 


class CharacterItemAdapter ( 
val character: MarvelCharacter, 
val clicked: (MarvelCharacter) -» Unit 


) : ItemAdapter«CharacterItemAdapter.ViewHolder» (R.layout.item character) ( 


override fun onCreateViewHolder(itemView: View) = 
ViewHolder (itemView) 


override fun ViewHolder.onBindViewHolder() ( 
textView.text = character.name 
imageView.loadImage (character.imageUrl) 
itemView.setOnClickListener { clicked(character) } 


class ViewHolder(itemView: View) : 
RecyclerView.ViewHolder(itemView) ( 
val textView by bindView«TextView» (R.id.textView) 
val imageView by bindView«ImageView» (R.id.imageView) 


} 
同时 还 需要 更 新 MainActivity， 如 下 所 示 : 


package com.sample.marvelgallery.view.main 





import android.os.Bundle 

import android.support.v7.widget.GridLayoutManager 
import android.view.Window 

import com.sample.marvelgallery.R 
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import com.sample.marvelgallery.data.MarvelRepository 

import com.sample.marvelgallery.model.MarvelCharacter 

import com.sample.marvelgallery.presenter.MainPresenter 

import com.sample.marvelgallery.view.character.CharacterProfileActivity 
import com.sample.marvelgallery.view.common.BaseActivityWithPresenter 
import com.sample.marvelgallery.view.common.addOnTextChangedListener 
import com.sample.marvelgallery.view.common.bindToSwipeRefresh 

import com.sample.marvelgallery.view.common.toast 

import kotlinx.android.synthetic.main.activity main.* 


class MainActivity : BaseActivityWithPresenter(), MainView ( 


override var refresh by bindToSwipeRefresh (R.id.swipeRefreshView) 
override val presenter by lazy 
{ MainPresenter(this, MarvelRepository.get()) } 


override fun onCreate(savedInstanceState: Bundle?) ( 
super.onCreate (savedInstanceState) 
requestWindowFeature (Window.FEATURE NO TITLE) 
setContentView(R.layout.activity main) 
recyclerView.layoutManager = GridLayoutManager (this, 2) 
swipeRefreshView.setOnRefreshListener ( presenter.onRefresh() } 
searchView.addOnTextChangedListener { 
onTextChanged { text, , , = 
presenter.onSearchChanged (text) 


) 
presenter.onViewCreated|() 


override fun show(items: List«MarvelCharacter») ( 
val categoryItemAdapters = 
items.map (this: :createCategoryItemAdapter) 
recyclerView.adapter = MainListAdapter (categoryItemAdapters) 


override fun showError(error: Throwable) { 
toast ("Error: ${error.message}") 
error.printStackTrace () 


private fun createCategoryItemAdapter (character: MarvelCharacter) 
= CharacterItemAdapter (character, 
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{ showHeroProfile (character) }) 


private fun showHeroProfile(character: MarvelCharacter) ( 
CharacterProfileActivity.start(this, character) 
5 
H 


在 上 述 实现 中 ， 使 用 了 源 自 CharacterProfileActivity 伴生 对 象 中 的 方法 ， 以 启动 Character 
ProfileActivity。 对 此 ， 需 要 向 该 方法 传递 MarvelCharacter 对 象 。 相 应 地 ， 传 递 Marvel 
Character 对 象 最 为 高 效 的 方式 是 以 打包 方式 对 其 进行 传递 。 针 对 于 此 ，MarvelCharacter 须 
实现 Parcelable 接口 。 这 也 是 一 些 有 效 方案 会 使 用 某 些 注解 处 理 库 的 原因 ， 例 如 Parceler、 
PaperParcel 或 Smuggler， 进 而 生成 所 需 的 元 素 。 此 处 将 使 用 项 目 中 现 有 的 、 源 自 Kotlin 
Android 扩展 的 解决 方案 。 在 本 书 编写 时 , 该 方案 仍 处 于 试验 阶段 , 因而 需要 在 build.gradle 
模块 中 添加 下 列 定义 : 


androidExtensions ( 
experimental - true 
























































} 

全 部 工作 是 在 类 前 添加 Parcelize 注解 ， 且 需要 该 类 实现 Parcelable。 除 此 之 外 ， 为 了 
隐藏 默认 的 Android 警告 消息 ， 还 须 禁 止 错误 输出 ， 如 下 所 示 : 

package com.sample.marvelgallery.model 

import android.annotation.SuppressLint 


import android.os.Parcelable 
import com.sample.marvelgallery.data.network.dto.CharacterMarvelDto 


import kotlinx.android.parcel.Parcelize 
@suppressLint ("ParcelCreator") 
GParcelize 


constructor(dto: CharacterMarvelDto) : this( 
name = dto.name, 
imageUrl = dto.imageUrl 


H 


至 此 ， 可 实现 start 函数 以 及 character 字段 ， 这 将 通过 属性 委托 从 Intent 处 获取 参数 ， 
如 下 所 示 : 


package com.sample.marvelgallery.view.character 





import android.content.Context 
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import 
import 
import 
import 
import 
import 
import 
import 
import 


class 
val 


ove 


} 


ove 


pri 
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android.support.v7.app.AppCompatActivity 

android.os.Bundle 

android.view.MenuItem 

com.sample.marvelgallery.R 
com.sample.marvelgallery.model.MarvelCharacter 
com.sample.marvelgallery.view.common.extra 
com.sample.marvelgallery.view.common.getIntent 
com.sample.marvelgallery.view.common.loadImage 
kotlinx.android.synthetic.main.activity character profile.* 


CharacterProfileActivity : AppCompatActivity() { 
character: MarvelCharacter by extra(CHARACTER ARG) // 1 


rride fun onCreate(savedInstanceState: Bundle?) { 

super. onCreate (savedInstanceState) 
setContentView(R.layout.activity character profile) 
setUpToolbar () 

supportActionBar?.title = character.name 
headerView. loadImage (character.imageUrl, centerCropped = true) // 1 


rride fun onOptionsItemSelected(item: MenuItem): Boolean = when { 
item.itemId == android.R.id.home -> onBackPressed().let { true } 
else -» super.onOptionsItemSelected (item) 


vate fun setUpToolbar() ( 
setSupportActionBar (toolbar) 
supportActionBar?.setDisplayHomeAsUpEnabled (true) 


companion object ( 


"com.s 


private const val CHARACTER ARG = 
ample.marvelgallery.view.character.CharacterProfileActivity.Chara 


cter ArgKey" 


fun start(context: Context, character: MarvelCharacter) ( 
val intent = context 
.getIntent«CharacterProfileActivity»() // 1 
-apply { putExtra(CHARACTER ARG, character) } 
context.startActivity (intent) 
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对 于 注释 1, 前 述 内 容 已 对 extra 和 getIntent 扩展 函数 有 所 讨论 , 但 尚未 在 当前 项 目 中 予以 
实现 。 另 外 ，loadImage 将 会 显示 一 条 错误 消息 。 
此 处 需要 更 新 loadImage， 并 将 extra 和 getIntent 定义 为 顶级 函数 ， 如 下 所 示 : 


// ViewExt .kt 
package com.sample.marvelgallery.view.common 








import android.app.Activity 

import android.content.Context 

import android.content.Intent 

import android.os.Parcelable 

import android.support.annotation.IdRes 
import android.support.v4.widget.SwipeRefreshLayout 
import android.widget.ImageView 

import android.widget.Toast 

import com.bumptech.glide.Glide 

import kotlin.properties.ReadWriteProperty 
import kotlin.reflect.KProperty 

import android.support.v7.widget.RecyclerView 
import android.view.View 


fun «T : View» RecyclerView.ViewHolder.bindView(viewId: Int) 
= lazy { itemView.findViewById«T» (viewId) } 


fun ImageView.loadImage (photoUrl: String, centerCropped: Boolean = false) 
t 
Glide.with (context) 
. load (photoUrl) 
.apply { if (centerCropped) centerCrop() } 
.into (this) 


fun <T : Parcelable> Activity.extra (key: String, default: T? = null) 
Lazy<T> 

= lazy ( intent?.extras?.getParcelable«T» (key) ?: default ?: throw 
Error("No value $key in extras") } 


inline fun «reified T : Activity» Context.getIntent() = Intent (this, 
T::class.java) 
VUES 
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如 果 不 打算 定义 函数 以 启动 Activity， 则 可 使 用 生成 此 类 方法 的 库 。 例 
如 ， 可 使 用 ActivityStarter 库 。 下 列 代 码 显 示 了 CharacterProfileActivity。 


class CharacterProfileActivity : AppCompatActivity() { 
@get:Arg val character: MarvelCharacter by argExtra() 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity character profile) 
setUpToolbar () 
supportActionBar?.title = character.name 
headerView. loadImage (character.imageUrl, centerCropped = true) // 1 


override fun onOptionsItemSelected(item: MenuItem): Boolean = when { 


item.itemId == android.R.id.home -> onBackPressed().let { true } 


else -» super.onOptionsItemSelected (item) 


private fun setUpToolbar() { 
setSupportActionBar (toolbar) 
supportActionBar?.setDisplayHomeAsUpEnabled (true) 


) 








随后 ， 可 通过 类 CharacterProfileActivityStarter 的 静态 方法 获取 其 Intent， 进 而 予以 启 | 











如 下 所 示 : 


CharacterProfileActivityStarter.start(context, character) 


val intent -CharacterProfileActivityStarter.getIntent (context, character) 


对 此 ， 需 要 在 build gradle 模块 使 用 到 kapt 插件 (用 以 支持 Kotlin 中 的 注解 处 理 )， 如 下 所 示 : 





apply plugin: 'kotlin-kapt" 


build.gradle 模块 中 的 ActivityStarter 依赖 项 如 下 所 示 : 


implementation 
'com.github.marcinmoskala.activitystarter:activitystarter:1.00' 


implementation 'com.github.marcinmoskala.activitystarter: activitystar 


terkotlin:1.00' 
kapt 'com.github.marcinmoskala.activitystarter:activitystartercompiler:1.00" 
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经 过 上 述 调整 后 ， 当 单 击 MainActivity 中 的 角色 人 物 时 ， 将 启用 CharacterProfile 
Activity， 如 图 9.30 所 示 。 

当前 操作 显示 了 名 称 以 及 人 物 角 色 的 照片 。 下 一 步 是 显示 描述 内 容 和 出 现 次 数 ， 对 应 
数据 位 于 Marvel API 中 ， 仅 需要 扩展 DTO 模块 即 可 获取 此 类 数据 。 对 此 ， 需 要 添加 用 于 
加 载 列表 的 ListWrapper， 如 下 所 示 : 










































































package com.sample.marvelgallery.data.network.dto 


class ListWrapper<T> { 
var items: List<T> = listof() 
} 








Data provided by Marvel. © 2017 MARVEL 





图 9.30 
同时 ， 还 须 定 义 ComicDto， 用 于 加 载 与 出 现 次 数 相关 的 数据 ， 如 下 所 示 : 


package com.sample.marvelgallery.data.network.dto 




















class ComicDto ( 
lateinit var name: String 
} 


下 面 将 更 新 CharacterMarvelDto， 如 下 所 示 : 





package com.sample.marvelgallery.data.network.dto 


class CharacterMarvelDto ( 
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lateinit var name: String 

lateinit var description: String 

lateinit var thumbnail: ImageDto 

var comics: ListWrapper«ComicDto» = ListWrapper () 
var series: ListWrapper«ComicDto» - ListWrapper() 
var stories: ListWrapper<ComicDto> = ListWrapper() 
var events: ListWrapper«ComicDto» - ListWrapper() 


val imageUrl: String 
get() = thumbnail.completeImagePath 
) 


当前 ， 数 据 将 从 API 中 读 取 ， 并 保存 至 DTO 中 ， 但 当 在 项 目 中 对 其 加 以 使 用 时 ， 还 
须 进一步 调整 MarvelCharacter 类 定义 ， 并 添加 新 的 构造 函数 ， 如 下 所 示 : 


@SuppressLint ("ParcelCreator") 
GParcelize 


class MarvelCharacter( 
val name: String, 
val imageUrl: String, 
val description: String, 
val comics: List<String>, 
val series: List<String>, 
val stories: List<String>, 
val events: List«String» 

) : Parcelable { 


constructor(dto: CharacterMarvelDto) : this( 
name = dto.name, 
imageUrl = dto.imageUrl, 
description = dto.description, 
comics = dto.comics.items.map { it.name }, 
series = dto.series.items.map { it.name ], 
stories = dto.stories.items.map ( it.name ], 
events = dto.events.items.map { it.name } 


) 
现在 更 新 CharacterProfileActivity， 并 显示 描述 内 容 和 出 现 次 数列 表 ， 如 下 所 示 : 
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class CharacterProfileActivity : AppCompatActivity() { 


val character: MarvelCharacter by extra(CHARACTER ARG) 

override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity character profile) 
setUpToolbar () 
supportActionBar?.title = character.name 
descriptionView.text = character.description 
occurrencesView.text = makeOccurrencesText() // 1 
headerView. loadImage (character.imageUrl, centerCropped = true) 


override fun onOptionsItemSelected(item: MenuItem): Boolean = when { 
item.itemId == android.R.id.home -» onBackPressed().let ( true } 
else -» super.onOptionsItemSelected (item) 


private fun setUpToolbar() ( 
setSupportActionBar (toolbar) 
supportActionBar?.setDisplayHomeAsUpEnabled (true) 


private fun makeOccurrencesText(): String - "" // 1, 2 

.addList(R.string.occurrences comics list introduction, 
character.comics) 

.addList(R.string.occurrences series list introduction, 
character.series) 

.addList(R.string.occurrences stories list introduction, 
character.stories) 

.addList(R.string.occurrences events list introduction, 
character.events) 


private fun String.addList(introductionTextId: Int, list: List« 
String»):String ( // 3 
if (list.isEmpty()) return this 
val introductionText = getString(introductionTextId) 
val listText = list.joinToString(transform = 
{ " $bullet $it" ), separator = "\n") 
return this + "$introductionText Wn$listText Wn Wn" 
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companion object ( 
private const val bullet = 'Nu2022' // 4 
private const val CHARACTER ARG = 
"com.naxtlevelofandroiddevelopment.marvelgallery.presentation.heroprofi 
le.CharacterArgKey" 


fun start(context: Context, character: MarvelCharacter) ( 
val intent - context 
-getIntent«CharacterProfileActivity»() 
-apply ( putExtra (CHARACTER ARG, character) } 
context.startActivity (intent) 


) 


对 于 注释 1， 出 现 次 数列 表 的 构成 相对 复杂 ， 因 而 可 将 其 从 makeOccurrencesText 函数 中 提 
取出 来 。 此 处 ， 针 对 每 个 出 现 种 类 漫画、 系列 等 )， 仅 当 存 在 对 应 类 型 的 出 现 次 数 时 ， 
方 需要 显示 介绍 文本 。 另 外 ， 还 需要 利用 项 目 符号 标注 各 个 数据 项 。 对 于 注释 2， 
makeOccurrencesText 表示 为 独立 表达 式 函 数 ， 并 使 用 addList， 通 过 下 一 个 需要 显示 的 列 
表 附 加 于 《初始 状态 下 ) 空 字符 串 。 如 果 所 提供 的 列表 为 空 ， 那 么 返回 的 字符 串 将 不 会 产 
生 任何 变化 ;否则 将 会 返回 一 个 字符 串 ， 该 字符 串 添加 了 介绍 文本 以 及 包含 项 目 符号 的 元 
素 列表 。 对 于 注释 4， 表 示 为 用 作 项 目 符号 的 字符 。 
除 此 之 外 ， 还 须 在 strings. xml 中 定义 字符 串 ， 如 下 所 示 : 
<resources> 
«string name-"app name">Marvel Gallery</string> 
<string name="marvel copyright notice"> 
Data provided by Marvel. . 2017 MARVEL</string> 
«string name="search hint">Search for character</string> 
<string name="occurrences_comics_list_introduction">Comics:</string> 
<string name="occurrences series list introduction">Series:</string> 
<string name="occurrences stories list introduction">Stories:</string> 


<string name="occurrences events list introduction">Events:</string> 
</resources> 


图 9.31 显示 了 人 物 角 色 的 全 部 资料 , 包括 人 物 角 色 名 称 、 图 像 、 描 述 内 容 ， 以 及 漫画 、 
系列 、 事 件 和 故事 中 的 出 现 次 数列 表 。 
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TAS 


Born with super-human senses 
and the power to heal from 
almost any wound, Wolverine was 
captured by a secret Canadian 
organization and given an 
unbreakable skeleton and claws. 
Treated like an animal, it took 
years for him to control himself. 
Now, he's a premiere member of 
both the X-Men and the Avengers. 


Data provided by Marvel. © 2017 MARVEL 








€ Wolverine 

yearo roi niii co vunu ur inner. 

Now, he's a premiere member of 
both the X-Men and the Avengers. 


Comics: 
*5 Ronin (Hardcover) 
+ 5 Ronin (Hardcover) 
* 5 Ronin (2010) #1 
* 5 Ronin (2010) #1 (AJA Cover) 
+ A*X (2012) #1 
* A+X (2012) #4 
* A*X (2012) #6 
+ A*X (2012) #9 
* ACTS OF VENGEANCE 
CROSSOVERS OMNIBUS 
(Hardcover) 
* ACTS OF VENGEANCE 
CROSSOVERS OMNIBUS (DM 
Only) (Hardcover) 
* Age of X: Alpha (2010) #1 

Data provided by Marvel. € 2017 MARVEL 


€ Wolverine 





TUUS i 
(1964 - 2009) 
- Amazing Spider Man Vol. 10: 
New Avengers (2005) 

* Amazing X-Men (2013 - Present) 
* Anita Blake: The Laughing 
Corpse - Necromancer (2009) 

* Annihilators: Earthfall (2011) 

* Astonishing Spider-Man/ 
Wolverine (2010 - 2011) 

* Astonishing Spider-Man/ 
Wolverine (2010 - Present) 


Stories: 

* Cover #477 

* X-MEN (2004) #164 
* Cover 4608 

* XMEN (2004) #159 
* XMEN (2004) 4157 
* XMEN (2004) #158 
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本 章 所 介绍 的 小 型 项 目 仍 存在 许多 需要 完善 的 地 方 。 在 该 应 用 程序 中 ， 讨 论 了 一 些 
Kotlin 的 应 用 示例 ， 并 以 此 简化 Android 开发 。 当 然 ， 读 者 还 可 进一步 研究 其 他 处 理 方案 。 
Kotlin 大 大 简化 了 Android 的 开发 任务 ， 例 如 监听 器 设置 、 视 图 元 素 引 用 等 诸多 常见 操作 ， 
同时 还 包括 一 些 高 级 功能 ， 例 如 过 程式 编程 和 集合 处 理 操作 。 

本 书 无 法 兼顾 Kotlin Android 开发 中 的 全 部 内 容 ， 仅 介绍 了 重要 的 概念 和 特性 。 下 一 
步 即 是 打开 Android Studio， 编 写 自己 的 项 目 ， 并 享受 Kotlin 的 开发 之 旅 ， 
现在 您 的 眼前 ! 











